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PREFACE 


This manual was written for customer systems programmers, DEC Software 
Specialists, and internal maintenance programmers. Readers must be 
familiar with the DOS User’s Manual, DEC-15-MRDA-D. In addition, chap- 
ter 8 requires familiarity with the BOSS Reference Manual, DEC-15-GUDA-D. 



CHAPTER 1 


DOS OPERATION 


The System Manager must use DOSSAV in order to load DOS-15 for the 
first time. The DOS System Generator manual, DEC-15-YWZB-DN12 , des- 
cribes DOSSAV operation in its appendix. After successful DOSSAV op- 
eration, the System Manager should load the Bootstrap into the highest 
bank. (This tells DOS how many banks it can use.) The Bootstrap loads 
the System Loader, which in turn loads the Nonresident Monitor. In 
order to ensure a working system, the System Manager should place the 
DOS-15 Checkout Package tape (RF.CHK, DEC-15-CIDA-PA, for RF DECdisk 
systems, or RP.CHK, DEC-15-CTAA-PA, for RP02 Disk Pack systems) into 
the Paper Tape Reader, and type BATCH PR^ . Operating instructions 
for the Checkout Package, and the tape itself, are distributed as part 
of the DOS-15 system. 

Once the system has been checked out, the System Manager should use 
DOSGEN, the DOS System Generator orogram, to tailor the system to 
his needs. As mentioned in the System Generator manual, a complete 
tailoring of the system may also involve use of PATCH, PIP, and 
UPDATE . 


Commands to the Nonresident Monitor allow temporary modification of 
the system, in order to suit the needs of a particular program. The 
Nonresident Monitor modifies the system by changing information in 
the .SCOM Table. The System Loader examines the . SCOM Table, along 
with three disk-resident information blocks, SYSBLK, COMBLK and SGNBLK, 
and carries out all operations necessary to fulfill the operator's 
commands. The System Loader "builds" the Resident Monitor by relocat- 
ing and linking those routines indicated by the .SCOM table as needed 
by the next core load. The Resident Monitor then retains general con- 
trol over the system. 
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CHAPTER 2 


THE RESIDENT MONITOR 


2.1 INTRODUCTION 

The Resident Monitor gets its name because it seems resident to the user. 
Strictly speaking, however, the only part of the system that is always 
resident is the Bootstrap. There are two parts of the system that are 
refreshed only after manual Bootstrap loads and restarts: . SCOM and the 
Resident Monitor Patch Area. Every time an operator or program changes 
certain key system parameters, the system will build a new Resident 
Monitor from blocks stored on the system device. 


The Resident Monitor is the interface between the operator, and the 
active devices on one hand, and the program which is running (the 
Nonresident Monitor), on the other. The Resident Monitor always contains 
the following routines and tables: 


Chapter 

5 


This 

Chapter 


f .DAT 
< . UFDT 

L . SCOM 

The CAL Handler, which routes all System and I/O 
Macro calls 

The Startup routine after using the Bootstrap 
.MED, the Monitor's standard error routine 
The Expanded Error Processor, for more flexibility 
with error messages 

Handlers for the following error conditions: 

Nonexistent Memory 
Memory Protect 
Interrupt-Memory Parity 
Power-Fail 

Software API not set up 

The Monitor's TRAN routine (different from I/O .TRAN's) 

A clock handler 

The .GTBUF and GVBUF processor 

The CTRL Q processor 

The .USER processor 

The .OVRLA processor 


TTA. 

The Resident Monitor's Patch Apea 


In addition, the user can request the system to retain certain other 
routines in a resident Monitor status: 


The CTRL X Feature, including a driver for the VT-15 
The Paper Tape or Card Reader Handler for Batch 
The Resident Batch code 

BOSS-15 also has resident routines, wnich are covered in Chapter 8. 
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2.2 THE CAL HANDLER 


The CAL instruction transfers control to register 21, bank 0, and loads 
register 2J7 with the address of the next instruction after the CAL. 

All DOS I/O and system macros take the form of a CAL instruction (pos- 
sibly with some code in the low-order bits) , and the next sequential 
register contains a dispatch code. Some macros require more informa- 
tion in succeeding registers. Figure 2-1, Resident Monitor CAL Handler, 
, i 

illustrates the operation of that portion of the Resident Monitor. The 
CAL Handler does only minimal error checking — for legal function 
code, and for legal .DAT slot. Aside from that, and ensuring the 
clock is turned on, the CAL Handler is only a dispatcher to other 

routines. 

2.3 IOPS ERROR HANDLER, AND THE EXPANDED ERROR PROCESSOR 

2.3.1 .MED 

There are two error processors in the Resident Monitor: .MED and the 
Expanded Error Processor. Figure 2-2 illustrates those routines. 

Figure 2-3 shows two subroutines used by the error routines. .MED 
(location 3, bank 0 ) processes IOPS errors from all device handlers 
except the disk handlers, and CDB., MTF . , TTA. , and LPA. Calls to 
•MED should take the following form, if not IOPS 4: 


LAC 

DAC* 

INFO 

(.MED 

/ARGUMENT OF 
/ADDRESS OF 

ERROR 

CAL IS ALREADY 

IN .MED, 

LAW 

N 

/IF DESIRED 
/N IS ERROR 

CODE j?>N^777. 

AC MUST BE NEGATIVE 

JMP* 

( .MED+1 




IOPS 4 messages may take the following form: 


LAC (4 /AC MUST BE POSITIVE 

JMS * {.MED 

. MED+1 contains a JMP to the Monitor Error Diagnostic Routine. The 
above calls to .MED will cause the following printouts: 

IOPSN (contents of .MED) 

I0PS4 
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ENTER 


1. Loa3 .MED with Tsr address 

2. Turn clock on, if not on 

3. Deposit minus 1 in register 7, 
ss or less than minus two 



The following CAL’s 
take this path: 

.EXIT, .OVKLA, .TIMER 
.SETUP, . GTBUF , 
.GVBUF, .GET, & 

.PUT 


Modify the 
.UFDT slot 


/ 

5s 

L 

Load AC with 
CAL address 

\ 

L 


Give control to 
proper portion of 
the Resident Mon- 
itor. 


Device Hand- 
ler carries 
out instruc- 
tion 



Exit to the 
user 


N 

N 

L 

Do Monitor TRAN 
(Figure 2-4 ) 

N 

L 


Bootstrap 


Resident Monitor CAL Handler 


Figure 2-1 




























Resident Monitor Subroutines 

Figure 2-3 
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2.3.2 The Expanded Error Processor 


The disk handlers (except the Bootstrap), CDB. , MTF. , TTA. , and LPA. 
use the Expanded Error Processor. Each error message is "potentially" 
recoverable by typing CTRL R. That is, the Resident Monitor always 
returns control to the caller upon a CTRL R. It is up to the caller 
to respond accordingly. All handlers supplied with the system simply 
repeat the error message if the error is unrecoverable. 

The Expanded Error Processor gives the capability of printing addi- 
tional information after the standard IOPS message. As with .MED, the 
AC must contain the error number (0<number£777 ) in bits 9-17. Control 
must be passed, however, via JMS* (.SCOM+37, not JMP* ( . MED+1* 

The following information pertains to the message: LOC+2 must contain 
the two's complement of the number of message words to be typed after 
the standard "IOPSNN nnnnnn" message. If the number is zero or posi- 
tive, no message will be printed. If the LINK is set, nulls will be 
printed as spaces. If the LINK is zero, nulls will be ignored. If 
the AC is positive on calling the expanded error facility, only the 
special message will be printed. The "IOPS" part will be omitted. 

The message itself must be packed in .SIXBT. 

The following are examples of use of the Expanded Error Processor: 

Example a: 


UNREC 

LAC 

STATUS 

/STATUS 


DAC* 

C.MED 

/CAL ADDRESS IS NOW OVERWRITTEN 




/BY CONTENTS OF STATUS REGISTER 


STL 


/TURN NULLS INTO SPACES 


LAW 

ERRNUM 

£ERRNUM <1000 


JMS* 

(.SCOM+37 


JMP 

UNREC 

/THIS IS AN UNRECOVERABLE ERROR* 
/JMP .-1 WILL NOT DO — EXPANDED 
/ERROR PROCESSOR CHANGES THE 
/CONTENTS OF .MED. 


LAW 

-1 



.SIXBT 

'DKA' 


UNITNO 

9 



.SIXBT 

1 FIL ' 



.SIXBT 

' E* 



.SIXBT 

'SRC' 




The printout from that code will be as follows: 

IOPS777 nnnnnn DKA FILE SRC 

where nnnnnn is the contents of .MED, and equals the Status Register 
B, and ERRNUM was 777. 
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61 


Example b: 

PARITY LAW 

STL /TURNS NULLS INTO SPACES 

JMS* ( . SCOM+37 

JMP RETRY /THIS IS A RECOVERABLE ERROR 

LAW -1 
. SIXBT ' DTA ' 

The printout from that code will be as follows: 

IOPS61 nnnnnn DTA 

where nnnnnn is the contents of .MED, the address of the last CAL, 
deposited by the CAL Handler. 

2.4 THE SYSTEM BOOTSTRAP 

The System Bootstrap is nothing more than a disk driver. It may load 
the System Loader and Resident Monitor from Hardware Readin, or manual 
restart. All other Bootstrap operations result from the use of the 
Monitor TRAN routine. The Monitor TRAN routine sets up the Bootstrap 
to read or write any block or set of contiguous blocks from the disk 
to or from any location in core. Before calling the Bootstrap, the 
Monitor TRAN does a .WAIT to all .DAT slots in the Mass Storage Busy 
Table, clears all flags, turns off the VT if it was on, and allows the 
clock to tick positive, so that it will keep time but not interrupt. 

After the Bootstrap has finished, it calls the Monitor Initialization 
Routine, which updates the clock and turns on the VT, if necessary. 


The Monitor TRAN Routine requires the following parameter table: 

BLKNUM /FIRST BLOCK NUMBER 

FIRSTA-1 /FIRST ADDRESS OF BUFFER, MINUS ONE 

-SIZE /# OF WORDS TO BE TRANSFERRED IN 2 ' S COM 

START /STARTING ADDRESS AFTER DISK I/O 

/COMPLETION 

The following code illustrates the use of the Monitor TRAN: 


PARADD LOC+0 
LOC+1 
LOC+,2 
LOC+3 


UNIT=100000 


/MONITOR TRAN WILL USE UNIT ONE 1 


SCOM=100 


LAC ( PARADD 
XOR UNIT 

STL 

JMP* ( . SCOM+55 


/MONITOR TRAN REQUIRES ADDRESS OF 
/PARAMETER TABLE IN BITS 3-17 AND 
/UNIT NUMBER IN BITS 0-2 OF AC 
/NONZERO LINK GIVES TRAN OUT 
/.SCOM+55 IS USER ENTRY POINT FOR 
/MONITOR TRAN 


See also paragraph 5.7. 


1 DECdisk TRANs ignore unit number, use block number. 
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.OVRLA, .EXIT, and manual Q dumps all use the Monitor TRAN routine. 

Figure 2-4, .OVRLA, .EXIT and CTRL Q, illustrates their operation, 

| 

and also the Monitor TRAN. 

For the RF DECdisk, the user can reference a specific platter just by 
identifying the block number he wants. That is, the block numbers to 
not automatically go to zero at the beginning of every platter. The 
block numbers and platter relationships are shown below: 


TABLE 2-1 

RF Platter-Block Number Correspondence 


Platter Number 

Block Number 

0 

0-1777 

1 

2000-3777 

2 

40J00-5777 

3 

6000-7777 

4 

10000-11777 

5 

12000-13777 

6 

14000-15777 

7 

16000-17777 

(All numbers are in octal) 


2.5 SYSTEM I/O INITIALIZATION 

| 

' 

There are two routines that do DOS I/O initialization: the startup routine 
after Bootstrap manual loads and restarts, and the startup routine 
performed after Monitor TRAN's and after a CTRL C, P, T or S for an 
error. The startup routine after Bootstrap loads is described in 
Figure 4-1, The System Loader Interface Routine. Figure 2-5, Resident 
Monitor Initialization, describes the other routine. 

2.6 RESIDENT MONITOR TIMING FEATURES 

Figure 2-6, The Resident Monitor Clock Routine, describes the Resident 
Monitor's time functions. There are three places in DOS which start 
or try to update the clock — (1) the first-time initialization after 
manual Bootstrap loads and restarts, (2) the Resident Monitor Initial- 
ization, and (3) the CAL Handler. The following .SCOM registers con- 
tain timing information: 
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.OVRLA 
CAL Entry 


Put System pro- 
gram name into 
.SCOM+43 ,44 (progj 
name pointed to 
by CAL+2) 



Scan Overlay 
Table (address in| 
•SCOM+31) for a 
match with the 
program name 


CLEAR* 
\ . INIT 

-Jk 


Put neime of the 

Nonresident Mon-J 
itor into .SCOM+j 
43 S 44 


> 

t 

Set up pointer to TRAN 
parameters 

> 

( 


Set up unit number 0 and 
pointer to TRAN parame- 
ters for loading . SYSLD 
Clear LINK for .TRAN in 



Update . SCOM+ 3 ; 
clear AC and the 
LINK (Unit 0, & 
.TRAN in) 


5 

N 

t 

Set AC » 777777 



f 


(MONITOR 


Store Unit number and 
other TRAN parameters 
in the Bootstrap 


Return to 
user 


CLEAR* 

(.WAIT) 


2k 

Put starting address into 

location 0, bank 0, and 
set the Bootstrap to go to 
Monitor Recovery Routine 
on exit 




TRAN ROUTINE — Independent from 
device handler .TRAN's) 


* CLEAR does a .WAIT or a 
. INIT to each entry in 
the Mass Storage Busy 
Table. This precludes 
conflicts between disk 
I/O performed by the 
system disk handler, and 
disk IOT's issued by the 
Bootstrap, an independent 
program. CLEAR also turns 
off the clock and PI, and 
enables BANK mode. 


.OVRLA, .EXIT and CTRL Q 
Figure 2-4 










J 

1. Update the clock, and allow it to 
interrupt 

2. Clear TTY Busy Switch (Clear all 
flags ensures no I/O to TTY) 

3. Turn API on or off, depending on 
contents of register 6 (The Sys- 
tem Loader loads register 6 ac- 
cording to . SCOM+4 , bit 0) 

4. Turn on PI 


Exit to 
Proper 
location 


Resident Monitor Initialization 


Figure 2-5 
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Allow clock to tick positive, so it 
will not interrupt for an hour 


N X ‘TIMER ^ 
in effect 



Subtract one from register 7, the clock register 



''"'Register ^s. 
.seven nega-^ 
^ s NJtive 


Restore pre- interrupt 
conditions 


Note; The Clock Routine will use PI if API is busy, or down. 


The Resident Monitor Clock Routine 

Figure 2-6 
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. SCOM+50 Time of day, in hhmmss (six bits each) 
•SCOM+51 Elapsed time, in ticks 

.SCOM+56 Time limit, in seconds (zero, if no limit) 
. SCOM+60 Time left for .TIMER interrupt (zero, if 
.TIMER not in effect) 

.SCOM+61 Address of .TIMER user interrupt routine 
.SCOM+73 Number of ticks left in the next second 
. SCOM+74 Line frequency, in ticks per second 


2.6.1 Clock Operation 


The Nonresident Monitor's TIME command changes or senses . SCOM+50. 
•SCOM+51 is not used by any system program. The clock handler simply 
increments it upon each clock tick. User programs may deposit a known 
quantity into .SCOM+51, in order to time events. The Nonresident 
Monitor deposits the argument for a TIMEST command into .SCOM+56. If 
.SCOM+56 is nonzero, the Resident Monitor will issue an ISZ .SCOM+56 
command each second, until it reaches zero. At such a time, the Resi- 
dent Monitor will perform a .EXIT. MICLOG, LOGIN, and LOGOUT clear 
.SCOM+56. 

2.6.2 .TIMER 


.TIMER allows users to schedule routines for a specified time from 
"now". These routines may return to the interrupted code, if the 
programmer desires. .TIMER users should take care that the time- 
dependent code follows certain rules : 


a. When a programmer does not wish to reset the .TIMER mechan- 
ism, but wishes to return to the interrupted program, his 
code should look like this: 


C 0 /C+l REACHED VIA JMS 

DAC SAVEAC /MUST NOT USE NON- REENTRANT CODE 

/POSSIBLY USED BY THE INTERRUPTED 
/PROGRAM. (INCLUDES THE CAL IN- 
STRUCTION) 

LAC C /RESTORE THE LINK 

RAL 

LAC SAVEAC /RESTORE THE AC 

XIT JMP * C 
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b. When the programmer does wish to reset the .TIMER mechanism, 
and return to the interrupted code, his routine should look 
like this: 


.SCOM 

=w 


CLON= 

700044 


CLOF= 

700004 


INTRVL=-100 

/THIS ROUTINE WILL RUN EVERY 100 R + 
/TICKS ° 

* 


DAC 

0 

SAVEAC 


LAC 

ADD RES 

/RETURN TO THE NEXT ROUTINE 

DAC* 

CLOF 

( .SCOM+61 

/TURN THE CLOCK OFF TO ENSURE NO 
/REENTRANCE BEFORE .TIMER RESET AND 
/RETURN 

LAC 

INTRVL 

/DESIRED INTERVAL IN TWO'S COMPLEMENT 

DAC* 

(.SCOM+6j2f 


LAC 

C 

/RESTORE THE LINK 

RAL 



LAC 

SAVEAC 

/RESTORE THE AC 

CLON 


/TURN THE CLOCK BACK ON (AFTER NEXT 
/INSTRUCTION) 

JMP* 

C 



c. When a programmer does not wish to return to the interrupted 
program, he need not save the AC, and he may use the CAL in- 
struction. He should beware of using I/O buffers that may 
still be modified by a handler's interrupt section. In many 
cases, a .INIT to an active .DAT slot will terminate I/O. 
Teleprinter I/O should be terminated by the following: 


XCT* (.SCOM+35 


The user should program a delay of at least 110 milliseconds 
after such an instruction, before he attempts teleprinter I/O 

Note: The interrupt routine will run at the level of the in- 
terrupted code, with the same addressing mode and memory pro- 
tect status. Thus, no debreak and restore is required. 
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2.7 THE RESIDENT MONITOR PATCH AREA 


There are two types of patch area taken from the space allocated at 
assembly time: 


1. That allocated by using PATCH 

2. That allocated when answering the Patch Area 
question in system generation 

Patch area one is the place for permanent changes to the Resident 
Monitor. It is always refreshed when the System Loader comes into 
core. Patch area two is only refreshed on manual Bootstrap loads 
and restarts. The second area would be appropriate for communication 
between successive programs loaded by the System Loader. This area 
should be used because the System Loader refreshes all of core, ex- 
cept the Bootstrap, .SCOM, the CTRL X buffer, and the patch area two. 

The combined size is limited by the current assembly at 47)30g. Both 
areas can be initialized, using PATCH. The important dividing line 
between area one and area two is register 1J31 (.SCOM+1) of RESMON. 

The way to allocate more space in part one is to increase the value 
of register 1J01. The way to change the area in part two is to use 
DOSGEN. The second part will start at the address in register 1)31. 

The upper bound of the second area will be the sum of the contents 
of register 1)31, and the number specified to DOSGEN. 

2.8 CONTROL CHARACTERS 

CTRL C, P, R, S, and T are all special characters that interrupt the 
current program and transfer control. The Resident Monitor ignores 
CTRL R except after IOPS 4 and any call to the Expanded Error 
Processor. CTRL S always transfers control to the address in .SCOM+6. 
In the case of core-image system programs and EXECUTE, a CTRL S will 
transfer to register zero, and result in an IOPS 3. The Linking 
Loader places the starting address of the first load module into 
.SCOM+6. 

A . INIT macro to the teleprinter handler will change the address of 
either CTRL C, P or T. The Resident Monitor is always initialized to 


2-14 



perform a .EXIT after CTRL C, and ignore CTRL P and T. DDT uses 
CTRL T , and CTRL P is ordinarily used by programs for restarts. 

MACRO-15 expands . INIT to change the CTRL P address. If the programmer 
expands .INIT without the aid of the assembler, a lj 0 in bits zero and 
one of LOC+2 will change the address of CTRL T. A 01 in those bits 
will change the address of CTRL C. It should be obvious that special 
care should be taken with CTRL C. In addition, modifications to the 
CTRL T address should not be made when debugging with DDT. There are 
cases, however, when such modifications are desirable. In particular, 
all zeroes in LOC+2 (2-17) will cause the teleprinter handler to ignore 
CTRL C, P, or T. This address might be used when sensitive code is 
being executed, as in DOSGEN. The following .INIT expansion will 
cause the Resident Monitor to ignore CTRL C: 


CAL-2&777 

1 

200000 
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CHAPTER 3 


THE NONRESIDENT MONITOR 


3 . 1 INTRODUCTION 

The System Loader brings the Nonresident Monitor into core after a 
hardware readin , a manual restart, a CTRL C, or a .EXIT. The RCOM 
Table, SGNBLK, SYSBLK and COMBLK are always coresident with the Non- 
resident Monitor. This gives the Nonresident Monitor access to all 
important system parameters. 

The Nonresident Monitor announces its presence by typing DOS-15 VN.A 
on the teleprinter. It remains in core until the operator requests 
another system program, or until the operator's command implies a 
refreshed configuration of the Resident Monitor is necessary. 

The Nonresident Monitor's actions are limited to (1) decoding commands, 
(2) manipulating or examining bits and registers in .SCOM, .DAT, .UFDT, 
SYSBLK, COMBLK, and SGNBLK, and (3) calling the System Loader, when 
necessary. The Nonresident Monitor has only one entry, which starts 
an initialization section. Figure 3-1, Nonresident Monitor Initial- 
ization, describes that logic. Every time the System Loader brings 
in the Nonresident Monitor, it passes control to the initialization 
section. After initialization, and after all commands that do not 
require the System Loader, the Nonresident Monitor types a $, and 
awaits an input line, terminated by a Carriage RETURN or an ALT MODE. 

It then examines the first six characters (or those up to the first 
blank) and tries to find an entry in the Nonresident Monitor's Command 
Table. If a match is found, control passes to the appropriate routine, 
and thence to the next command, or the System Loader. If the typed 
command does not correspond to an entry in the command table, the 
Nonresident Monitor temporarily assumes the operator wishes a new 
core-image system program, and checks COMBLK for a corresponding entry. 
If there is no corresponding entry in COMBLK, the Nonresident Monitor 
will type an error message, and await the next command. If COMBLK 
contains a matching entry, the Nonresident Monitor composes a .OVRLA, 
and passes control to the System Loader via that .OVRLA. 
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1. Bank bit initialize pointers to SYSBLK, COMBLK and SGNBLK 

2. Determine the number of positive .DAT slots 

3. Save the contents of .DAT-12, in case the user desires LP ON 

(restore before leaving Nonresident Monitor) 

4. Save contents of .SCOM+7 — Nonresident Monitor will use 
.SCOM+7 for address of LPA. or TTA. 

5. Change all .UFDT entries that equal BNK or PAG to SYS 

6. Compute addresses of .DAT-2,+1,+5 and +6 

7. Compute address of beginning of I/O Device Table in SGNBLK 


Returning*"^ 
from a Nonresident 
"^Monitor .EXITx" X 


KEEP ON 



Restore .UFDT and 
.DAT to SGEN values 


Initialize .DAT-2 and 
.DAT- 3 


Returning 
from a Nonresident 
Monitor »EXIT/^ 


^ In \ 
OSS Mode' 


Type out Nonresi- 
dent Monitor's name 


Has\^ 
a date beet 
v entered/'* 




(next page) 

Nonresident Monitor Initialization 
Figure 3-1 
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(Continue to Command Decoder) 


Nonresident Monitor Initialization 
(continued) 


Figure 3-1 (Cont.) 







3.2 COMMANDS TO THE NONRESIDENT MONITOR 


This paragraph discusses legal commands listed in the Nonresident 
Monitor's Command Table. Table 3-1, Effects and Exits for Nonresident 
Monitor Commands, describes all commands that do not request a new 
program. 

There are five entries in the Command Table that load relocatable 
system programs. They are DDT, EXECUTE, GLOAD and LOAD. The Non- 
resident Monitor treats these commands separately, because SYSBLK 
does not list them. All information, necessary for loading these pro- 
grams resides in the Nonresident Monitor itself. 

3.3 CONSIDERATIONS FOR ADDITIONS TO THE NONRESIDENT MONITOR 

Programmers should not attempt to add commands to the Nonresident 
Monitor unless they have access to a copy of the source code. The 
source code may be purchased from Digital Equipment Corporation, 

146 Main Street, Maynard, Massachusetts, under one of the order num- 
bers listed in the footnote. They should then use the EDITOR program 
to put in the indicated changes, and reassemble. 


New additions to the Nonresident Monitor require the following actions 

1. Update the Nonresident Monitor's Command Table. 

The Command Table is in two parts: 

a) The . SIXBT names of the commands 

b) The corresponding transfer vector 

2. Write the code for the command. 

3. Consider the kind of exit the command will take: 

a) Commands that end with a request for a new 
command should end with JMP KLCOM 

b) Commands that re-configure the Nonresident 
Monitor should end with JMP NRMEXl. 


DECtape DEC-15 -SRDA-Ul 
Magtape Unavailable 
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Table 3-1 


Effects and Exits 
for Nonresident Monitor Commands* 


COMMAND 

MODIFIER 

ACTION TAKEN 

EXIT 

API 

ON 

OFF 

Set bit 0 of . SCOM+4 . 

Clear bit 0 of .SCOM+4. 

.EXIT 

.EXIT 

ASSIGN 

handler 

(and/or) 

UIC 

Check whether handler is available. 

If yes, load .DAT slot with proper 
handler code. (The proper loader 

will load the handler, and insert 
its starting address into the .DAT 
slot. 

Load proper slot via a .USER 

Next 

Command 

Next 

Command 

BANK 

ON 

OFF 

Set bit 11 of .SCOM+4. 

Clear bit 11 of .SCOM+4. 

Next 

Command 

BATCH 

PR 

CD 

Set bit 0 and clear bit 2 in loca- 
tion 1777 of the Bootstrap's bank. 

If bit 2 of .SCOM+33 is set (i.e., 
if VT is ON) and bit 17 of .SCOM+33 
is set (i.e., CTRL X is set for VT) , 
set bit 1 of .SCOM+33 in order to 
tell the Resident Monitor Initializa- 
tion to start up CTRL X. 

Set bits 0 and 2 of location 1777 of 
the Bootstrap's bank, and set bit 1 
of .SCOM+33 as with BATCH PR. 

.EXIT 

.EXIT 

BUFFS 

number 

Put number indicated into .SCOM+26, 
and set Nonresident Monitor Initial- 
ization to leave .SCOM+26 alone. 

Next 

Command 

CHANNEL 

7 

9 

Clear bit 13 of .SCOM+4. 

Set bit 13 of .SCOM+4 

Next 

Command 

DATE 

date 
no date 

Enter date into .SCOM+4 7. 

Print date from .SCOM+4 7. 

Next 

Command 

* This 

table assumes error-free input. 
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Table 3-1 (cont. ) 


Effects and Exits 
for Nonresident Monitor Commands 


COMMAND 

MODIFIER 

ACTION TAKEN 

EXIT 

GET 

GETP 

GETS 

GETT 


Set Section 3.4. 


HALF 

ON 

OFF 

Set bit 0 of .SCOM+33. 

Clear bits 0 and 1 of .SCOM+33. 

.EXIT 

.EXIT 

HALT 


If not in BOSS-15 mode, put a HLT 
instruction (instead of a JMP) into 
the exit from non-IOPS 4 errors to 
.MED. If in BOSS mode, do nothing. 

Next 

Command 

INSTRUCT 

none 

ERRORS 

Print INSALL Table. 

Print INSERR Table. 

Next 

Command 

KEEP 

ON 

OFF 

Set bit 16 of . SCOM+42 . 

Clear bit 16 of .SCOM+42. Initial- 
ize to SGEN default values all en- 
tries in .DAT and .UFDT, except 
change SCR default values to current 
UIC. 

Next 

Command 

LOG 


Output five spaces after Carriage 
RETURNS. After ALT MODE, go to' 
next command . 

Next Com- 
mand (after 
ALT MODE) 

LOGIN 

uic 

Redefine current UIC (.SCOM+41). 

Clear bit 0 of .SCOM+42, reset vari- 
able system parameters to SGEN de- 
fault values zero .SCOM+56. 

.EXIT 

LOGOUT 


Set current UIC to SCR. Set .UFDT 
entries to SGEN default parameters. 
Deposit zero into .SCOM+42 and 56. 

.EXIT 

LOGW 


For BOSS-15, print message. In all 
cases, after a Carriage RETURN, out- 
put five spaces. After ALT MODE, 
type four bells IP , and await CTRL P. 
After CTRL P, go to next command. 

Next Com- 
mand (after 
ALT MODE) 
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Table 3-1 (cont.) 


Effects and Exits 
for Nonresident Monitor Commands 


COMMAND 

MODIFIER 

ACTION TAKEN 

EXIT 

LP 

ON 

Set bit 3 of .SCOM+42. 

.EXIT 


OFF 

Clear bit 3 of .SCOM+42. 

.EXIT 

MICLOG 

mic 

Check key with SGNBLK . If correct. 

Next 



set bit 0 of .SCOM+42, make "SYS" 
the current UIC, and zero . SCOM+56. 
If incorrect, ignore command. 

Command 

PAGE 

ON 

' 1 

Clear bit 11 of .SCOM+4. 

Next 


OFF 

Set bit 11 of .SCOM+4. 

Command 

PROTECT 

n 

If n is between 0 and 7, inclusive. 

Next 



enter it into .SCOM+54. 

Command 

PUT 


See Section 3.4. 


QDUMP 


Enter MANSAV, the address of the 
manual CTRL Q, into the exit from 
non-IOPS 4 errors to .MED. 

Next 

REQUEST 

none 

Print the current assignments for 

Next 



.DAT and . UFDT . 

Command 


USER 

Print the current assignments for 
all positive .DAT and .UFDT slots. 



prog 

Print required .DAT and .UFDT slots, 
and the assignments and use for each 

• 

.SCOM 


Print the information for the cur- 

Next 



rent system. 

Command 

TIME 

time 

Enter time into . SCOM+50. 

Next 


none 

Print time from . SCOM+50. 

Command 

VT 

ON 

Set bit 2 of .SCOM+33. 

.EXIT 


OFF 

Clear bits 1, 2, and 17 of .SCOM+33. 
Execute 703,044. 


X4K 

ON 

Enter 400000 into . SCOM+20. 

Next 


OFF 

Deposit zero into . SCOM+20. 

Command 

33TTY 

ON 

Clear bit 2 of .SCOM+4. 

.EXIT 


OFF 

Set bit 2 of .SCOM+4. 
















































4. After assembly, the programmer must call PATCH, in 

order to make his relocatable binary program absolute. 
Commands to PATCH should be as follows : 

>D0S15 £ 

>READR 16077 DOSNRM BINj 

16077 indicates the highest location the new monitor 
can occupy. (SYSBLK begins at 16100.) DOSNRM BIN 
happens to be the file name used by program develop- 
ment. The programmer may, of course, substitute his 
own file name. More information may be found in the 
PATCH manual — DEC-15-YWZB-DN5 . 


3.4 QFILE 


QFILE is a system program that allows users to (1) store core images 
in named files, and (2) retrieve such core images for examination via 
DUMP (or possibly for a slow, core-swapping capability) . QFILE imple- 
ments the following Resident Monitor system macros and Nonresident 
Monitor commands: 


.GET, GET, GETP, GETS, GETT , .PUT and PUT 


Users can not obtain QFILE by typing its name to the Nonresident 
Monitor. The Resident Monitor will load QFILE as part of its response 
to the commands and macros listed above. 


PUT creates a file that contains the data in the CTRL QAREA; .PUT 
creates a file from the current core image. GET, GETP, GETS, GETT 
and .GET all overlay core with the contents of the QAREA or file. (The 
different commands specify different startup locations.) In addition 
to the above capabilities, the Resident Monitor provides the capability 
of overlaying core with the contents of the CTRL Q area. The follow- 
ing instructions show how to use that routine: 


UNITN0=4 00000 /UNIT FOUR 

. SCOM=100 


LAC 

START 

XOR 

UNITNO 

JMP * 

( . SCOM+6 4 


/STARTING ADDRESS AFTER THE CTRL Q 
/GET 

/UNIT NUMBER IN HIGH-ORDER THREE BITS 
/ADDRESS OF CTRL Q GET ROUTINE 
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Figure 3-2, QFILE, and Implementation of GET and PUT Logic, shows 
the information flow associated with QFILE. QFILE uses the follow- 
ing registers: 


.SCOM+7,10 & 11 
. SCOM+65 


.SCOM+66-71 
.DAT- 14 


. SIXBT Filename and Extension 


Command parameters, packed as follows: 


Bits j?-2 
Bit 8 
Bit 9 
Bits 15-17 


Device unit number 
NRM PUT, when set 
PUT logic, when set 
Function Code 


CTRL Q Area parameters 

File must be on the device assigned 
to this .DAT slot. 


NOTE 

All GET and .GET operations change all 
of core, except registers J? through 4 
of bank zero. 
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.GET CAL & 
NRM GET'S 


.PUT CAL 


Nonresident 
Monitor PUT 



Note: This chart assumes error free input. 


QFILE, and Implementation of GET and PUT Logic 


Figure 3-2 











CHAPTER 4 


THE SYSTEM LOADER AND THE LINKING LOADER 


The System Loader is the third major oart of the DOS-15 Monitor. The 
other two are the Resident and Nonresident parts. The Resident and 
Nonresident Monitors communicate with the System Loader by manipulat- 
ing certain .SCOM registers. When commands to either part imply a 
new configuration is needed, that part sets up the appropriate .SCOM 
registers, and passes control to the System Bootstrap via the Monitor 
TRAN routine. The Bootstrap then loads the System Loader into high 
core, and gives it control. 

The System Loader examines the .SCOM registers, and loads a fresh copy 
of the Resident Monitor, including any features that the user wishes 
to be resident, such as the CTRL X feature. It will also load the 
desired system program and all handlers required by the new configura- 
tion. In addition, it will allocate all required buffers. The Non- 
resident Monitor is treated like any other core-image system program. 

The System Loader never loads user programs. It only loads core-image 
system programs, the Linking Loader and Execute. The latter two load 
user programs ? 

The System Loader uses two device handlers to interface with the disk: 
the System Bootstrap, and the System Loader Disk Handler (DKL.). DKL. 
arrives in core along with SYSBLK, COMBLK and SGNBLK, as well as the 
loader itself. The Bootstrap loads core image programs only. The DKL. 
takes care of relocatable programs and any handlers loaded by the 
System Loader. Those include all handlers for core-image system programs, 
the Linking Loader's own handlers, and any needed by the Execute file. 

The Linking Loader loads some handlers needed by user programs it links. 

There are two parts to the System Loader: the System Loader Interface, 
and the System Loader proper ( . SYSLD) . Figure 4-1 describes the System 
Loader Interface. Figure 4-2 describes the System Loader Proper, and 
Figure 4-3 describes the Linking Loader. 
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I»W] 


Fra 


Turn on the clock 

Initialize 

.SCOM+0 

First free reg- 
ister below the 
Bootstrap 

.SCOM+4 

SGEN default 

. SCOM+20 

Bit zero set, if 
extra 4K; rest 

zero 

.SCOM+33 

VT & HALF, as 
per SGEN 

.SCOM+74 

Line frequency 

1 -Move to highest bank 1 


Zero .SCOM+36, to indicate no entries in the Mass Storage 
Busy Table 

Move Resident Monitor into lower core 
Set up: Jump to Skip Chain 

CAL* error 
Legal CAL jump 

Turn API on or off, depending on bit 0 of .SCOM+4 (set=on) 
Bank bit initialize Resident Monitor to talk to the 
Bootstrap, and load .SYSLD into the proper bank upon a 
subsequent .EXIT or .OVRLA. 

Initialize the Bootstrap with the proper IOPS 4 address for 
disk not ready 

Calculate the Skip Chain from SGNBLK 

Set all API channel registers to point to IOPS 3 (with the 
exception of the clock interrupt) and all software levels 
to point to IOPS 30 

Put transfer vector to .DAT slots into .SCOM+23 
Put number of positive .DAT slots into .SCOM+24 
Put pointer to .UFDT+0 into . SCOM+25 


^/was 
.last, program" 
Nonresident 


.TRAN image of .DAT 

.TRAN image of .DAT 

and .UFDT in from 

and .UFDT out to 

block 37 of the sys- 

block 37 of the sys- 

tern device, unit 0 

tem device, unit 0 


1. Zero .DAT-7 (i.e., not yet set up) 

2. Set up .DAT-2 and .DAT-3 for TTA. 

3. Update .SCOM+1 and +2 to point 
just above the Skip Chain, .DAT 
and . UFDT 
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From Preceding Page 



1. Put number of system device's "A" handler (DKA. or DPA. ) 
into .SCOM+57 

2. Set up tabbing for current teleprinter 

3. Set .SCOM+20 to initial state (as in first time initialization) 

4. Set up for CTRL Q — ignore Q-dumps if RF system and QAREA too 
small, or nonexistent 

5. Set up for IOPS errors upon the followincr interrupts: 

Nonexistent Memory (IOPS 31) 

Memory Protect Violation (IOPS32) 

Memory Parity Error (IOPS33) 

Power Fail Not Set Up (IOPS34) 



Set switch to ig- 
nore input until $JOB 



Next Page 

System Loader Initialization 
Figure 4-1 (Cont. ) 
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From Preceding Page 

it 


1. Set up CTRL C to clear the Batch Switch (bit 1 of 17777 
of the Bootstrap) 

2. Set up CTRL T to abort current job, and start the Batch 
Monitor looking for the next $JOB line 

3. Relocate proper batch handler (PR or CD) to low core 

4. Put handler entry point into .DAT- 2 

5. Set IOPS errors to abort job — effectively a CTRL T 

6. Set up all batch device .DAT slots to refer to the hand- 
ler currently in core. That is, only one batch input 
device is allowed at any one time 

7. Clear $JOB read switch (bit 1 of Bootstrap 17777) 

8. Perform .INIT to .DAT-2 


Clear bits 14, 15 
and 17 of .SCOM+42 



Relocate Resident BOSS 
and link it to the DOS 
Resident Monitor 

2. Patch DOS Resident Mon- 
itor to accomodate BOSS 

3. Set bits 14, 15 and 17 
of .SCOM+42, to tell 

. SYSLD to set up .DAT-7 
and +6 



Relocate and 
link CTRL X 
code , and give 
proper buffer 



Set up linkages between 
CTRL X code and the 
Resident Monitor 




Next Page 

System Loader Initialization 

Figure 4-1 (Cont.) 
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From Preceding Page 


^XLoadingX. 

N / a relocatable^ 
program .X" 

N X^Loading^v. Y 
"\EXECUTEX^~ 


Tell .SYSLD by setting 
.SCOM+11 to XCS (avoids 
two handlers in core for 
same device) 



System Loader Initialization 

Figure 4-1 (Cont. ) 
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,1. Allocate number of 
buffers indicated 
by . SCOM+26 

\2. Set up File Buffers 
Transfer Vector 
Table in .SCOM+30 
3. Set . SCOM+6 * 0 
A. Put 13 into . SCQM+5 


1. Allocate the number of buffers 
indicated by .SCOM+26 

2. Set up File Buffers Transfer 
Vector Table pointer, in .SCOM+30 

3. Store one of the following codes 
into .SCOM+6: 


4. Zero 


LOAD 
GLOAD 
DDT 
DDTNS 
. SCOM+5 


100000 

300000 

400000 

500000 
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System Loader Initialization 

Figure 4-1 (Cont.) 
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Set up for Page or Bank Mode 

Set up .DAT-7 for the System Loader disk handler (DKA. or DPA.) 

Clear free core, and initialize bank bits in pointers to the Bootstrap 
Make a Mass Storage Busy Table consisting of one entry 


Loading 

EXECUTE 



Set up CTRL P 
address 


. SCOM+11 
= . SIXBT 

xcs y 


1. Change XCS to XCT 

2. Allow reading of 
EXECUTE file by the 
System Loader Handler 


Clear memory bank pointers of banks that 
do not exist 





Load handlers into extra 4k, 
if it exists 





Put System Device's code into 
. DAT+0, to allow subsequent 
insertion into .DAT-7 


png 


Next Page 
The System Loader 

Figure 4-2 











From Preceding Page 


IOPROS 

.DAT+0,+6 


Which 

Program 


EXECUTE 


/ IOPROS: all \ 

' .DAT slots in \ 
table just undexy 
\ Bootstrap / 


Linking 

Loader 


IOPROS 
.DAT-1. -5 



1. Translate the handler code from radix 
50 to . SIXBT 

2. Do .USER to . UFDT-7 , using "IOS" 

3. Do . INIT and .SEEK to .DAT-7, in order 
to get the handler file 

4. Load handler via .DAT-7, and close .DAT-7 


''Loading' 1 

Linking 

sLoader^ 


N (EXECUTE) 


N — not 


Loaded 

^EXECUTE file's 
^\handlers 


Read EXECUTE file 
for desired handlers 


< IOPROS \ 

.DAT slots from \ 
EXECUTE file / 

dicated .DAT slot contains zero, 
the slot is unassigned, and IOPROS 
returns. If not zero, IOPROS checks 
whether the desired handler has al- 
ready been loaded. If the handler 
is in core, IOPROS loads the .DAT 
slot with the handler's starting ad- 
dress and returns. If the handler has 
not been loaded, the handler code is made 
an unresolved .GLOBL, to be satisfied 
by the loop that follows immediately. 

The System Loader 

Figure 4-2 (Cont. ) 


Set up Mass Storage Busy 

Table Entries for all 

active .DAT slots 

Set . SCOM+1 to first free 

location in core — often 

becomes first location of 

EXECUTE 


next page 







From Preceding Page 


Load and relocate EXECUTE or the Linking 
Loader, and place starting address into 
.SCOM+5 


Linking 


1. Set up Mass Storage Busy table with 
one entry per active .DAT slot 

2. Move the IOC table from the System 
Loader's area (just beneath the 
Bootstrap) to the Linking Loader's 


r 


b 


V. 

J 


Allocate all necessary buffers 
If the system has an extra 4K, 
put the first free address beneath 
the handlers into .SCOM+20 
Update first free location in core 
shown in . SCOM+2 — .OVRLA updates 
the first free address beneath the 
Bootstrap, . SCOM+3 


BOSCKl 


/ Exit via A 
V .OVRLA J 

Subroutine BOSCKl does the following, if loading a program under BOSS-15 
(1) .USER to . UFDT— 7 , (2) .SEEK to .DAT-7 for PRCFIL PRC. 


The System Loader 
Figure 4-2 (Cont. ) 











Clear all of core above the loader, including the extra 4K, if present, and 
excluding the Bootstrap 

Initialize the Load Table with the first free address in every bank or page 
Indicate all core below the address in .SCOM+2 as not free 
Compute transfer vectors to .DAT-1, -3, -4, -5, and -7, and a pointer to 
. UFDT-1 

Save the contents of .UFDT-1 



Load DDT and set the 
symbol flag, if not 
DDTNS 


Type appropriate 
name, and await 
command string 



1. Check for P, G and C switches 

2. Translate all file names after left arrow into .SIXBT, pad with blanks, 
and store in symbol table 

3. After ALT MODE, load to end-of-file each file on .DAT-4, and put starting 
address of the first file (i.e., not DDT) into .SCOM+6 



Load \ 
from Paper 


After every end of tape, type +P 
and await CTRL P — continue 
until number of tapes equals the 
number of commas, plus one 


Next Page 

The Linking Loader 


Figure 4-3 








From Preceding Page 



The Linking Loader 

Figure 4-3 (Cont. 


Next Page 
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From Preceding Page 


Need any 
of the Loader's 
s. handlers ^ 


Above all of 
sits handlers^ 


Set .SCOM+2 above the 
Loader's highest hand- 
ler — no handler is 
overlayed 



Set .SCOM+2 below all 
of the Loader's hand- 


Allocate the Mass Storage Busy Table, 
with the number of entries equal the 
sum of the active .DAT slots, minus 
one — i.e., the two .DAT slots for 
the teleprinter are omitted, and one for 
.DAT-7 is added 




^Control goes 
to address in 
V . SCOM+6 


Put lowest address of 
the Symbol Table into 
.SCOM+11, and the high- 
est into .SCOM+2 — 

DDT will recalculate 
.SCOM+2 



Await 
CTRL S 


/Control goes 
to address i 
s.SCOM+5 (DDT) 


The Linking Loader 
Figure 4-3 (Cont.) 
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4.1 MANUAL BOOTSTRAP LOADS AND RESTARTS 


Manual Bootstrap loads and restarts bring blocks 0-36 of the system 
device into the lowest bank. These blocks contains the Resident Moni- 
tor, the System Loader Interface Routine, and SYSBLK, COMBLK and SGNBLK. 
Figure 4-4 illustrates the core load after manual Bootstrap loads and 
restarts. The Interface sets up . SCOM+0, 4, 20, 27, 33, 54 and 74 
from SGNBLK values determined at system generation time, and then 
transfers the whole core image of the Interface to the Bootstrap's 
bank. (DOS requires 16K, because this bank must be different from 
bank 0.) At all other times, the Bootstrap loads the System Loader 
into its own bank. This preserves the image of .SCOM, part two of 
the Resident Monitor patch area, and the CTRL X buffer. 

4.2 LOADING SYSTEM PROGRAMS 

The System Loader Interface Routine gets control in the highest bank, 
either by a transfer from the lowest bank, or by load from the Boot- 
strap. After setting up for the System Loader Proper (.SYSLD), accord- 
ing to the program to be loaded and the settings of certain SCOM regis- 
ters, the Interface Routine brings it in as a complete overlay. Figure 
4-5 illustrates the core configuration of the Interface when it is 
in the highest bank. (The addresses provided are for a 16K system.) 

The System Loader loads handlers from the lowest part of free core up, 
with the exception that the extra 4K is filled first, if it exists. 

Core image system programs are usually loaded just beneath the Bootstrap 
(always in the highest bank) . Such core images must be wholely within 
the top bank of core, and above register 17 of that bank. Figure 4-6 
illustrates the core maps for system programs. 


Whenever the Linking Loader is loaded (LOAD, GLOAD, DDT, and DDTNS) , 
the System Loader loads all handlers for .DAT slots -1, -4, and -5, 
and then loads the Linking Loader itself. (DDT is loaded by the 
Linking Loader.) Figure 4-7 illustrates the core maps for the Linking 
Loader. 

For EXECUTE, the System Loader loads EXECUTE'S handler, and reads the 
EXECUTE file, in order to determine the active .DAT slots. The System 
Loader then loads all the handlers required, and sets up the .DAT 
slots. Figure 4-8 illustrates core maps for EXECUTE. 


4-13 





Figure 4-4 
Bootstrap Load 


LOADED PROGRAMS 

ON DDT LOADS, SYMBOLS 
ARE MOVED INTO THE 
LOWEST PART OF FREE CORE. 


SYMBOLS AND PROGRAMS BUILD 
TOWARD EACH OTHER. 


Figure 4-5 

Standard 
Interface Load 


LOADER HANDLERS 


(THIS AREA IS USED BY CORE 
IMAGES. SOME ROOM UNDERNEATH 
THE BOOTSTRAP MAY BE LEFT 
FREE FOR COMMUNICATION 
BETWEEN CORE IMAGES IN AN 
OVERLAY STRUCTURE. 

CORE IMAGES MUST BE 8K OR 
LESS.) 


BUFFER POOL 
TRANSFER VECTORS 


RESIDENT MONITOR 


•Placement of .SCOM+2 depends on relative 
positions of the Linking Loader and its handlers. 


OVERLAY SYSTEM 
BLANK COMMON 


HANDLERS, BUFFERS 


BUFFER POOL 
TRANSFER VECTORS 


RESIDENT MONITOR 


Figure 4-7 
Linking Loader 


ALL HANDLERS REQUIRED 


RESIDENT MONITOR 


Figure 4-6 

System 
Program Load 


Figure 4-8 
Execute 
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BOSS-15 Mode operation requires the system "A" handler be assigned to 
.DAT-7. This requires a sleight of hand on the part of the System 
Loader, which needs the "L" handler on .DAT- 7. It therefore loads 
the "A" handler as if it were assigned to .DAT+pf, and transfers the 
set up .DAT slot $ contents to .DAT-7 before transferring control to 
the program being loaded. . DAT+0 is then restored to its original 
status . 

4.4 TABLES AND INFORMATION BLOCKS USED AND BUILT BY LOADERS 

The System Loader uses SYSBLK, COMBLK, SGNBLK, block 37 of the system 
device, .SCOM, the RCOM Table, the IOC Table, the Device Table, the 
Mass Storage Busy Table, the File Buffers Transfer Vector Table, the 
Overlay Table, .DAT, . UFDT and three bits in the Bootstrap. Tables 
4-1, 4-II and 4-III describe how the Loaders use these blocks and tables. 


4.5 .DAT SLOT MANIPULATION BY THE SYSTEM LOADER 

The System Loader maintains the .DAT slot device handler assignments 
as they were the last time the Nonresident Monitor was in core. The 
Loader saves the .DAT and .UFDT on the system device whenever the 
Nonresident Monitor was the last program in core. Thereafter, the 
Loader refreshes .DAT and .UFDT from the image on the disk. If KEEP 
is off, the Nonresident Monitor's initialization routine restores the 
.DAT and .UFDT to default values. 


When loading core-image system programs, the System Loader determines 
the active .DAT slots by examining COMBLK. When loading EXECUT, the 
System Loader sets up .DAT- 4, and any active slots indicated by the 
Execute file itself. When loading the Linking Loader, the System 
Loader sets up .DAT-1, -4, and -5. The Linking Loader will set up other 
other active .DAT slots according to the . IODEV commands in the as- 
sembly of the program units being loaded. 


Both the System Loader and the Linking Loader set up .DAT slots in 
this manner: (In the following procedure, "loader" refers to either 

one . ) 
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Table 4-1 


Tables and Block^ 


Used by the Loaders 


NAME 

USE 

LOCATION 

SYSBLK 

The System Loader obtains Monitor TRAN 
parameters from SYSBLK when it builds 

16500 of 
. SYSLD' s bank 

COMBLK 

Indicates number of buffers required, 
the active .DAT slots, and the names 

17100 down, in 
. SYSLD 's bank 

SGNBLK 

Default settings for .SCOM registers, 
number of words per buffer, size of 
Resident Monitor's patch area (part 
two). Skip Chain, .DAT and .UFDT de- 
fault contents, and handler informa- 
tion . 

16100 of 
. SYSLD 's bank 

Block 37 
of the Sys- 
tem Device 

Image of .DAT and .UFDT, when last pro- 
gram was loaded (excluding the Nonresi- 
dent Monitor). 


.SCOM Table 

See Table 4-II. 

100 of 1st bank 

RCOM Table 

Moved for use by the Nonresident Monitor. 

17500 of the 
highest bank 

IOC Table 

Built by Interface Routine for . SYSLD 
itself . 

Just beneath 
the System 
Loader 

Device 

Table 

Built by Interface Routine if loading 

PIP, or if PIP is among the overlays 
listed in COMBLK 

Just above 
. SCOM+1 

Mass Storage 
Busy Table 

Built by the System Loader itself. 

Pointed to by 
. SCOM+6 2 

File Buffers 
Transfer Vec- 
tor Table 

Allocated by the Interface Routine, and 
initialized by it for non-core Image 
programs. System Loader proper initial- 
izes for core-image programs. 

Pointed to by 
. SCOM+30 

Overlay 

Table 

Built by the Interface Routine 

Pointed to by 
. SCOM+31 

.DAT 
and 
. UFDT 

Image stored and restored from block 37 
of the System Device. The System Loader 
loads all handlers for core-image pro- 
grams and EXECUTE Files, and sets up 
the appropriate .DAT slots. The System 
Loader also loads handlers assigned to 
.DAT-1, -4, and -5 when loading the 
Linking Loader, and .DAT- 7 and +6 for 
BOSS-15. 

Pointed to by 
. SCOM+23 and 
. SCOM+25 

BOOTSTRAP 

Bits 0, 1, and 2 of location 17777 in 
the Bootstrap's bank used for Batch (non- 
BOSS) information. 






































Table 4-II 


.SCOM REGISTERS USED BY THE SYSTEM LOADER 


. SCOM+ 

Description of Use by the System Loader 

0 

Set in first-time initialization routine. Used to locate 
the System Loader Command Area, which is just below the 
Bootstrap . 

1 

System Loader Interface routine updates this indication 
of the first free register above the Resident Monitor 
each time it moves a piece down to low core. 

2 

The Interface and . SYSLD itself continually update this 
indication of the first free location as they move code 
and build tables. 

3 

Updated as with .SCOM+2. Last free location in core. 

4 

First Time Initialization routine sets this register ac- 
cording to a SGNBLK parameter. 

Refer to Table 4-III. 

5 

Interface Routine stores code of program to be loaded 
into .SCOM+5. .SYSLD uses .SCOM+5 for starting address 
when loading EXECUT or LOAD. The . OVRLA routine loads 
.SCOM+5 with starting address of the Monitor Recovery 
Routine. The Bootstrap transfers to the address in 
.SCOM+5 after all its operations. 

6 

Interface Routine stores codes for DDT, DDTNS , LOAD and 

GLOAD into .SCOM+6. For other programs, the Interface 
Routine zeroes .SCOM+6. 

7 

.SYSLD saves contents of .DAT-1 in .SCOM+7, when loading 
the Linking Loader. When loading EXECUT, .SCOM+7 con- 
tains the first three characters of the Execute file's 
name. Contains .DAT-12 when loading Nonresident Monitor. 

10 

.SYSLD saves contents of .DAT-4 in SC0M+1J3, when loading 
the Linking Loader. When loading EXECUT, . SCOM+10 con- 
tains the second three characters of the Execute file's 
name . 

11 

.SYSLD saves contents of .DAT-5 in . SCOM+11, when loading 
the Linking Loader. When loading EXECUT, .SCOM+11 con- 
tains the extension of the Execute file's name. (The 

Interface routine sets .SCOM+11 to XCS , telling .SYSLD 
that EXECUT will be using the system device. .SYSLD 
then restores .SCOM+11 to XCT. ) 

12- 

15 

The Interface routine initializes these transfer vectors 
for API software levels to point to SERR, an error routine 
that will produce an IOPS3J2L 

16, 

17 

Unaffected. 

























Table 4-II CCont'd) 


SCOM+ 


Description of Use by the System Loader 



Bit zero set in first time initialization, if system con- 
tains an extra 4K. If the system does contain an extra 
4 k, the System Loader will load handlers in that page — 
from the bottom up — when loading a core-image program. 
Whenever there is an extra 4K, the System Loader will 
update bits 3-17 with the address of the first free cell 
in the extra 4K. 


Unaffected. 








Unaffected. 


The Interface Routine refreshes this pointer to .DAT. 


The Interface Routine refreshes this indication of the 
number of positive .DAT slots. 


The Interface Routine refreshes this pointer to . UFDT+0. 


When the Nonresident Monitor was the last program, the 
System Loader allocates the number of buffers indicated 
by the contents of .SCOM+26. If the Nonresident Monitor 
was not the last program, the System Loader restores 
.SCOM+26 to the default value if program to be loaded is 
core image. Otherwise, untouched. 


The first time initialization routine sets this indica- 
tion of the number of words per file buffer. 


The Initialization Routine loads this pointer to the 
File Buffer Transfer Vector Table. 


When loading a core-image program, the Interface Routine 
loads .SCOM+31 with the pointer to the Overlay Table, or 
with zero, if there is none. 


Unaffected. 


See Interface Routine table, to determine how that routine 
reacts to the bits in .SCOM+33. 


34, 35 Unaffected. 


System Loader loads with the number of active .DAT slots 
assigned to the system device. 


37-42 Unaffected. 


43, 44 Contains name of the program to be loaded. 




Unaffected. 


System Loader loads with the number of entries in the 
Mass Storage Busy Table. 


60, 61 Unaffected. 




System Loader loads with the address of the first entry 
in the Mass Storage Busy Table. 


Unaffected . 
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Table 4-III 


Use of . SCOM+4 by the System Loader 


Bit 

0 

If set, place "API ON" constant into 0000J76 - 
If clear, place "API OFF" constant in same register. 

» — 1 

Ignored . 

2 

If set, change the Resident Monitor so it will tab 
with the KSR 35/37 tabbing mechanism. 

3 

Loader will set this bit, if loading the Nonresident 

Monitor; clear it otherwise. 

4-6 

Ignored. 

7 

Loader sets this bit if bit 11 is cleared, and load- 
ing the Linking Loader or Execute. Otherwise clear. 

8 

Sets or clears, after comparing current core size 
(known by location of Bootstrap, and status of bit ft , 

. SCOM+2J3) with SGNBLK parameter. Also, modifies 

Resident Monitor to give IOPS77 after attempts to use 

CTRL Q. 

o 

i — i 

0> 

Ignored 

11 

Indicates whether to clear or set bit 7, when loading 

Linking Loader or Execute. 

12-17 

Ignored 
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1 . 


Each .DAT slot will contain a handler number — either the 
system default, or one inserted via an ASSIGN command to 
the Nonresident Monitor. This handler number is the rela- 
tive location of the handler name in the IOC Table, which 
the Interface Routine builds. (The IOC Table contains 
handler names in Radix 50.) 

2. For each active .DAT slot, the loader uses the handler 
number in that slot to find the name in the IOC table, and 
converts the name to .SIXBT. 

3. If the handler is already in core, the loader simply inserts 
the starting address of the handler into the .DAT slot. 

4. If the handler is not yet in core, the loader does a .SEEK 
to IOS for the handler, reads it into core, relocates it, 
and places the starting address of the handler into the 
.DAT slot. 


The System Loader always sets up .DAT- 2 and -3. (It reserves .DAT- 7 
for its own use.) When not in non-BOSS Batch Mode, -2 is assigned 
to TTA. In non-BOSS Batch Mode, the batch input device goes to -2. 
If loading the Nonresident Monitor and bit three of .SCOM+42 is set, 

the System Loader will set up .DAT-12 for the LPA, if it is in the 
system, or else for TTA. If in BOSS mode, the Nonresident Monitor 
assigns LPA. to . DAT+6 , and the System Loader assigns .DAT-7 to the 
system device "A" handler. The System Loader then ensures that both 
handlers are in core. The Resident BOSS set up routine subsequently 
routes all .DAT slots connected to TTA. to Resident BOSS. 


4.6 BUFFER ALLOCATION BY THE SYSTEM LOADER 

The System Loader allocates space for buffers equal to the contents 
of . SCOM+26 times the contents of .SCOM+27. The first time initial- 
ization routine sets .SCOM+27 to the standard number of locations per 
buffer. Before the Nonresident Monitor does an . OVRLA to a software 
system program, it checks whether a BUFFS command has been issued. 

If so, it leaves .SCOM+26 as is. If not, it uses the default number 
of buffers for that program, as shown in SYSBLK . 


4-20 



CHAPTER 5 


SYSTEM INFORMATION BLOCKS AND TABLES 


5.1 CORE-RESIDENT NON-REFRESHED REGISTERS 

The . SCOM table, the Bootstrap and the resident Patch Area are the 
only registers not refreshed by the System Loader. Table 5-1 de- 
scribes the .SCOM Table. 

5.2 DISK- RESIDENT UNCHANGING BLOCKS: SYSBLK , COMBLK AND SGNBLK 

SYSBLK, COMBLK and SGNBLK occupy blocks 34, 35, and 36 (octal) on the 
system device (unit zero). SYSBLK and COMBLK (blocks 34 and 35) contain 

the parameters for loading all core image system programs. SGNBLK con- 

I 

tains all the other information needed to run DOS. All three arrive 
in core along with the Resident Monitor and the System Loader Inter- 
face, and start at location 16100 of the highest bank. The Nonresident 
Monitor and System Loader use them, and DOSGEN and PATCH modify them, 
when necessary. 

I 

5.2.1 SYSBLK 

SYSBLK contains the parameters required for implementation of . OVRLA 
to any system program, or any of the system program overlays. 

The order of entries in SYSBLK is unimportant, except for the first 
three permanent entries: RESMON, . SYSLD , and iQAREA. The first word 
of SYSBLK contains the block address (the unrelocated address) of the 
first free word after itself. Figure 5-1 describes SYSBLK. 

5.2.2 COMBLK 

COMBLK contains information the System Loader and the Nonresident 
Monitor need to remember about the current core-image system programs. 
The last location in COMBLK (that is, location 377 of block 35) con- 
tains the block address of the first entry in COMBLK. The remainder 
of COMBLK consists of variable-length entries associated with the 
system programs. The Nonresident Monitor searches COMBLK when it 
finds no match for a typed command in its own Command Table. Figure 
5-1 illustrates the organization of COMBLK. The System Generator adds 
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TABLE 5-1 


.SCOM Registers 


■II 

iHUi 

mm 

MEANING 

9 


First register below the Bootstrap (set by the 

System Loader Interface) 

1 


First register above the Resident Monitor (set by 
the System Loader Interface) 

2 


Lowest free register available for storage (set 
by the System Loader or the Linking Loader) 

3 


Highest free register available for storage (set 
by the System Loader, the Linking Loader or DDT) 

4 


Initialized from SGNBLK values by the "first time" 
section of the System Loader Interface Routine, 
and by the LOGIN, LOGOUT and MICLOG logic of the 
Nonresident Monitor; modified by the Nonresident 
Monitor, unless otherwise indicated. 

0=1 

API is available. 

1 = 1 

EAE is available (always set) 

2 = 1 

Teleprinter is Model 35 or 37 

m 

Nonresident Monitor is in core 

4,5 

Reserved 

■m 

9-Channel Magnetic Tape System 

7 = 1 

Page Mode Operation 

ma 

QAREA inadequate for current core size (set by 
the System Loader Interface Routine) 

mm 

DOS disk file structure (always set) 

10 = 1 

RB09 disk is system device. 

11 = 1 

Bank Mode System 

12,13 

Line Printer Line Size: 

00 No Line Printer 

01 80 Characters 

10 120 Characters 

11 132 Characters 

14 = 1 

Background/Foreground System (always clear) 

15- 17 

Drum size (ignored — DOS does not support drum) 





































TABLE 5-1 (Cont'd) 

MEANING 

Core Image System Program starting address. 
DDT in core. 

GLOAD 

DDTNS 



API Level 4 service routine entry point 

API Level 5 " 

API Level 6 

API Level 7 " 

Program Counter on Keyboard Interrupts. 

AC on Keyboard Interrupts . 

20K or 28K system. 

First free address in top page. 

Magtape Status Register. 

Reserved for Magtape Handler. 

Pointer to . DAT+j?. 

Number of positive .DAT slots. 

Pointer to . UFDT+0. 

Number of buffers. 

Number of words per buffer. 


Pointer to Buffer Transfer Vector Table. 

















































TABLE 5-1 (Cont'd) 



Pointer to first entry in the Overlay Table (zero, 
if none) . 


Bad block number on IOPS 2 $ and 72. 


CTRL X status register. 


Display Buffer already set up. 


If VT ON, display mode is on. 


If in BOSS mode, elapsed time in seconds. 


Instruction to clear TT Busy Switch. 


Number of Entries in the Mass Storage Busy Table. 


Entry point for Expanded Error Processor. 


JMP to Expanded Error Processor. 


The logged-in UIC. 


Bit Register. 


MICLOG successful. 


.EXIT from Nonresident Monitor. 


. OVRLA from Nonresident Monitor. 


LP ON — LPA to .DAT-12 when loading Nonresident 
Monitor . 


Dump core on calls to .MED (except IOPS 4) . 


Halt on calls to .MED (except IOPS 4) . 


Set up . DAT+6 (used by BOSS Mode) . 


Load System Device Handler into .DAT-7. 


KEEP ■ ON . 


BOSS Mode. 


. SIXBT Representation of the name of the core 
image system program to be loaded (if any) . 


.SIXBT Representation of the name of the Non- 
resident Monitor 
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TABLE 5-1 (Cont'd) 



■9 

MEANING 

47 


Date (MMDDYY) 

50 


Time (HHMMSS ) 

51 


Elasped time, in ticks. 

52 


BOSS Bit Register 

0 = 1 

B0SS15 Mode. 

1 = 1 

Control Card Read by user, 5/7 ASCII image saved 
in first block of NRBOSS. 

mm 

Resident BOSS reached "EOF" on run time file (RTF) . 

3 = 1 

User exceeded time estimate. 

4 = 1 

I/O CAL to go to TTY. 

5 = 1 

Terminal IOPS error by user. 

6 = 1 

QDUMP to be given to user on IOPS errors . 

7 = 1 

Operator abort (Control T) . 

8 = 1 

Job active. 

■HI 

Exit from B0SS15 Mode. 

10 = 1 

User tried to do a .PUT. Core will be dumped and 
a listing given on LP. 

11 = 1 

User tried to do a .GET. 

12 

Not defined. 

13 

Not defined. 

14-16 

. SYSLD error number. 

17 = 1 

Job abort. 

53 


Reserved for CTRL X code. 

54 


Default Protection Code. 

55 


Entry to Monitor TRAN routine . 

56 


Two's complement of time limit, in seconds (zero, 
if no limit) . 

57 


System Device Code, for use by the Linking Loader. 


60 


Number of ticks until clock interrupt specified 
in last .TIMER (zero, if .TIMER not in use). 


















































TABLE 5-1 (Cont'd) 


REGISTER 

BIT 

MEANING 

61 


.TIMER address. 

62 


Address of the first word in the Mass Storage Busy 
Table . 

63 


Number of words per Mass Storage Busy Table Entry. 

64 


JMP to CTRL Q GET routine. 

65 


QFILE Communication Register. 

66 


First Block of the CTRL Q Area. 

67 


Starting Address minus one of the CTRL Q Area. 

v 9 


Two's complement of number of word in Qdump 

71 


Starting Address after DUMP or GET. 

72 


Starting Address after CTRL Q. 

73 


Two's complement of the number of ticks left in the 
next second. 

74 


Two's complement of the line frequency. 

75 

■ 

Number of RTF Lines (for BOSS Mode) . 

76-105 


Unused. 
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Word # 


Value 


Description. 



0 

000nnn 

Pointer to first free word after SYSBLK 

. 


(There is one set of seven words/core 


. SIXBT 
.SIXBT 

image program. ) 

7N+1 

7N+2 

Name of System Program or overlay 

7N+3 

nnnnnn 

Number of first block on system device 
occupied by this program or overlay. 

7N+4 

0000nn 

Number of blocks occupied by this pro- 
gram or overlay 

7N+5 

addres 

Thirteen-bit first address for this 
program or overlay 

7N+6 

0nnnnn 

Program size 

7N+7 

addres 

Thirteen-bit starting address for this 

• 

• 

program or overlay 



000010 

. SIXBT 
. S I XBT 
.SIXBT 
.SIXBT 
000002 


. DATS 777 
. DAT Still 

000005 

.SIXBT 

.SIXBT 

000001 


. DAT & 7 7 7 


Number of words in this entry (in this 
case, 10 ) 

Name of this system program (left- 
justified and zero-filled) 

Name of an overlay (left- justified and 
zero-filled) — overlays are optional 
Number of buffers required by this sys- 
tem program (Bits 0-5 = 0 means the end 
of any overlay names. This is why pro- 
gram and overlay names must be left- 
j ustif ied. ) 

Active .DAT slot 

Active .DAT slot (Note: 777777 for a .DAT 
slot means all positive .DAT slots.) 
Number of words for this entry (in this 
case, 5) 

Name of this system program 

Number of buffers required by this pro- 
gram (Note that his program has no over- 
lays . ) 

.DAT slot for this program 


000500 Pointer to first word in COMBLK (equals 

count from first word in SYSBLK) . The 
two contiguous blocks on the system de- 
vice that hold SYSBLK and COMBLK are 
treated by the system as one large block, 
In this case, COMBLK happens to start at 
location 500 of the two blocks combined. 
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names of core-image system programs by making them the new' first entry. 
In this way, SYSBLK and COMBLK build toward the center. 

5.2.3 SGNBLK 

SGNBLK (block 36 on the system device) contains all the system param- 
eters not directly associated with core-image system programs. The 
bulk of SGNBLK is concerned with I/O (.DAT slots, . UFDT slots. Skip 
Chain Order, Handlers, and skip IOT codes and mnemonics). The first 
few registers hold such important system information as the system de- 
vice, .SCOM+4 contents, and so on. The very first word in SGNBLK 
points to the block address of the first free word after SGNBLK. The 
next entry is an offset word indicating the total length (including 
itself) of the miscellaneous system parameter table to follow. This 
table includes the size of the .DAT and the size of the skip chain. 

The end of the handler and skip IOT table is the first free entry of 
the block. 

The .DAT slot table corresponds to the legal range of .DAT slots, 

with the maximum negative set to -15 and the maximum positive set to 

a number not to exceed 77_. The .DAT slots are in the form in which 

o 

they appear when the Nonresident Monitor is in core. That is, the 
unit number is in bits 0-2, and the number of the handler right- 
justified in bits 3-17. The handler number for the first handler in 
the Device Handler-Skip IOT Table is zero, for the pseudo-handler NON. 
TTA. is one, and so on. The constant 100000 indicates a fixed or il- 
legal .DAT slot (such as -2, -3, and 0). DOSGEN will not modify such 
slots . 

The . UFD Table is in one-to-one correspondence with the .DAT slot Table 
An entry of .SIXBT 'UIC' indicates that the logged in UIC is to be sub- 
stituted for the name UIC in the table. An entry of .SIXBT 'SYS' in- 
dicates BNK or PAG is to be substituted, in accordance with the current 
addressing mode. Otherwise, the contents of each location will be the 
.SIXBT representation of the corresponding .UFD slot. 

The Skip Chain Table lists the system skip IOT's in order. A negative 
skip (one that skips on "off", not "on") is represented in one's com- 
plement. Not all skips in the handler Skip IOT Table (described be- 
low) need to be included in the Skip Chain Table. 
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The Device Handler/Skip IOT Table contains all the handler names and 
skip IOT numbers and mnemonics for each I/O device identified to the 
system. Every such device has an entry in the table. A handler name 
must be exactly three characters in length, with the last character 
not an octal digit. The device code for a device is exactly two 
characters. The first two characters of each handler name for a de- 
vice must be the device code. This fact is essential for understand- 
ing the format of a device entry, since the device code is never 
stored as such in an entry, but is inferred from the device handler 
name. The typical entry for a device is the following: 

1. The first words of an entry contain the handler names 
for a device in .SIXBT. Each handler name is differ- 
ent, and the end of the list of handlers is determined 
by a word with zeros in bits 0-5 (the first character 
position ) . 

2. The word that terminated the list of handler names 
contains the number of skip IOT's for the device. 

For each skip IOT, there are three words in the table: 
two for the skip mnemonic and one for the actual code . 

The next device entry follows the last skip for the previous device. 
Handlers may be entered without any skips, but no devices may be 
entered without at least one handler name. Figure 5-2 illustrates 
the organization of SGNBLK. Appendix D of SGEN-DOS Utility Programs , 
DEC-15-YWZB-DN12 , lists SGNBLK, SYSBLK and COMBLK , as they are supplied 
by Digital Equipment Corporation. 

5.3 DISK-RESIDENT CHANGING BLOCKS 

The System Loader uses block 37 of the system device to store an image 
of .DAT and . UFDT . Other disk-resident changing blocks are the storage 
Allocation Table and the Bad Allocation Table. These tables are de- 
scribed in Chapter 6. 

5.4 TEMPORARY TABLES BUILT FROM DISK-RESIDENT TABLES 
5.4.1 The Overlay Table 

The System Loader builds the Overlay Table from the entries in SYSBLK 
referenced by a core-image system program's entry in COMBLK. That is, 
the Overlay Table contains an entry for the system program itself, and 
one for each of its overlays. Figure 5-3 illustrates the format of an 
entry in the Overlay Table. The first entry in the Overlay Table is 
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Location 

Value 

Description 

0 

000nnn 

Pointer to first free entry in SGNBLK 

1 

000015 

Number of miscellaneous parameters 

2 

000nnn 

Size of .DAT plus size of . UFDT = (number of posi- 
tive .DAT slots+16)*2. (Initial value is 20 posi- 
tive .DAT slots.) 

3 

000nnn 

Number of skips in Skip Chain 

4 

041300 

042000 

System device code in .SIXBT 

5 

nnnnnn 

Original contents of . SCOM+4 

6 

nnnnnn 

Original contents of .SCOM+20 

7 

nnnnnn 

Number of words per buffer (.SCOM+27) 

10 

nnnnnn 

Default number of buffers (.SCOM+26) 

11 

. SIXBT 

Monitor Identification Code 

12 

nnnnnn 

Information on VT and CTRL X (.SCOM+33) 

13 

00000n 

Default files protection code (.SCOM+54) 

14 

00nnnn 

Size of the Resident Monitor Patch Area 

15 

7777nn 

Minus the number of clock ticks in a second (-74 
for 60 hz, -62 for 50 hz.) 

16 

000nnn 

Device assignments for the .DAT (made by handler 

* 


numbers) . (Termination at 53 assumes 20 positive 

53 

000nnn 

slots . ) 

54 

. SIXBT 

UIC assignments for the .UFDT. (Termination at 



111 assumes 20 positive slots.) 

111 

.SIXBT 


112 

nnnnnn 

Skip Chain Table (Negative skips in one's comple- 

' 


ment.) (Termination at 137 assumes 22 skips in 

* 


chain . ) 

137 

nnnnnn 

140 

.SIXBT 

The last part of the SGNBLK is the Device Handler- 


* 

Skip IOT Table. Each entry starts with the .SIXBT 


" 

representations of all handlers for a particular 


.SIXBT 

.SIXBT 

device. (First two characters equal device code, 


for all handlers.) Zeros in the first six bits 


of a word indicate the end of the handler names. 


* 

and says that the rest of the word contains the 


.SIXBT 

000003 

nnnnnn 

nnnnnn 

nnnnnn 

.SIXBT 

number of skips for this entry's device. The skip 


IOT's follow immediately. As above, one's comple- 


ment skips indicate negative skips. Note, however, 


the confusing fact that a one's complement of a 


skip IOT is a positive number. Thus, 70nnn com- 


plemented is 07nnnn. 


000001 



nnnnnn 


312 

# 

SGNBLK ends at 312, in the DOS-15 system distrib- 
uted by Digital Equipment Corporation. 


Figure 5-2 
SGNBLK 
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pointed to by .SCOM+31. .SCOM+31 will contain zero, if there are no 
entries in the Overlay Talble. This will occur during Linking Loader 
or EXECUTE loads. 

.OVRLA is the only Monitor function that looks at the Overlay Table. 

If the .OVRLA processor finds a match to the .OVRLA argument in the 
Overlay Table, it uses the parameters listed in the table to bring 
it in via a Monitor TRAN. Note that this bypasses the System Loader, 
and does not change the handler load. Thus, the overlay must use only 
those .DAT slots required by the original program, the one listed in 
COMBLK. 

If the .OVRLA processor does not find a match in the Overlay Table, it 
calls in the System Loader, which searches COMBLK for the requested 
program. This type of overlay request does not require that .DAT slot 
assignments be the same. On the other hand, the System Loader refreshes 
all of core except .SCOM, etc. Thus, communication between overlays 
is more difficult. The resident patch area, however, can be used for 
this purpose. 

5.4.2 The Device Table 

The Device Table is built by the System Loader interface whenever PIP 
is being loaded, or when PIP is listed in COMBLK among the overlays 
for a program. It is located just above the register pointed to by 
. SCOM+1 , and has an entry for each positive .DAT slot. If a slot has 
an assigned device, the low-order twelve bits of the corresponding 
entry in the Device Table will contain the device's code, in .SIXBT. 

Bit 3 is set when the slot is busy. If no device is assigned to a 
slot, the corresponding entry in the Device Table will contain zero. 

5.4.3 The Input/Output Communication (IOC) Table 

The System Loader Interface builds the IOC Table and locates it just 
below the first register of the System Loader. It contains an entry 
for each handler in the system, in the order that they appear in 
SGNBLK . The entries themselves contain the handler name in Radix 50. 

The System Loader and the Linking Loader use the handler number sup- 
plied by the Nonresident Monitor to index down the IOC Table. They 
use the contents of the entry for a .SEEK to the IOS UIC. 
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5.4.4 The Device Assignment Table (.DAT) 


The Device Assignment Table makes the association between logical and 
physical devices. The Monitor knows its location by the contents of 
. SCOM+2 3 , which points to the zero 1 * entry in the Table. Specific slots 
are found by indexing on the contents of .SCOM+2 3. The number of nega- 
tive slots is fixed at 15 Q . The number of positive slots is specified 

o 

by .SCOM+2 4, and may be any positive number less than 100 g. It is 
specified at system generation time. 

The Nonresident Monitor places the handler number in the low order 
bits and the unit number in the high order bits. It derives the hand- 
ler number from SGNBLK . As mentioned above, the System Loader and 
the Linking Loader subsequently use the IOC Table to determine the 
handler name. After either loader has loaded and relocated a handler, 
it places the handler's starting address in all .DAT slots that refer- 
ence that handler. The unit number remains in the high-order three 
bits. Slots with no handler (NON) contain zero. Active .DAT slots 
are designated by COMBLK, for core-image system programs, and by . IODEV 
pseudo-ops for the Linking Loader and EXECUTE. 

5.4.5 The User File Directory Table (.UFDT) 

. UFDT+0 is offset from . DAT+0 (pointed to by .SCOM+2 3) by the sum of 
the positive and negative .DAT slots. Each .DAT slot has a correspond- 
ing .UFDT slot. UIC's in the .UFDT are packed in .SIXBT. The address 
of .UFDT+0 is stored in .SCOM+25. 

5.4.6 The Skip Chain 

Register 1 of Bank 0 contains a jump to the beginning of the Skip 
Chain. The Skip Chain is defined during System Generation, is located 
in SGNBLK, and is rebuilt every time the System Loader is called in. 

The System Generator Manual (DEC-15-YWZB-DN12 ) describes considerations 
for constructing the Skip Chain. 

5.5 TEMPORARY TABLES BUILT FROM SCRATCH 
5.5.1 File Buffer Transfer Vector Table 

The System Loader allocates space for the buffer pool, and creates the 
File Buffer Transfer Vector Table. .SCOM+30 points to the first entry 
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in the table, and the number of entries is specified by .SCOM+26. 

Each entry in the table contains the address of a buffer, or its one's 
complement. Negative addresses indicate a busy buffer. Since refer- 
ences to buffers must be indirect anyway, buffers are allocated with- 
out regard to bank boundaries. 

5.5.2 The RCOM Table 

The Nonresident Monitor requires certain information about the Resi- 
dent Monitor that does not warrant reserving additional .SCOM registers. 
The System Loader therefore puts this information into the RCOM table, 
whenever it is loading the Nonresident Monitor. The RCOM Table starts 
at register 17500 of the highest bank. 

5.5.3 The Mass Storage Busy Table 

Entries in this table are allocated by the System Loader or the Link- 
ing Loader. The Mass Storage Busy Table is pointed to by .SCOM+62. 
.SCOM+63 contains the number of words per entry in the table, and 
.SCOM+36 contains the current number of entries. Generally speaking, 
there are as many entries in the Busy Table as there are active .DAT 
slots, although the disk handlers are the only ones that currently 
refer to the Busy Table. 

The . INIT command to a disk handler establishes a Busy Table entry. 

The .CLOSE command (or the Rewind .MTAPE command) deletes the corres- 
ponding entry. Figure 5-4 illustrates a typical Busy Table Entry. 

The first word of an active entry in the Busy Table contains the .DAT 
slot in bits 9-17. The disk handlers save information about the UFD 
current for this .DAT slot in the Mass Storage Busy Table. They save 
information about the file current to the .DAT slot (if any) in the 
buffer pointed to by word 1 of the Busy Table Entry. More information 
on the disk handlers and file structure is contained in Chapter 6. 


5.6 RESERVED WORD LOCATIONS 

Word locations 0 through 77 are dedicated systems locations and can- 
not be employed by the user. The contents of these locations are 
described in Table 5-5. 
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Contents 


Word # 

Contents 

N,N+1 

. SIXBT name of Overlay 

N+2 

First block number 

N+3 

First address, minus 1 

N+4 

Size, in two's complement 

N+5 

Fifteen-bit starting address 


Table 5-3 Overlay Table 


Word # 

Contents 

N 

Device Type^_ 2 , Unit Number 3 _ 5 , Write Cheeky , . DAT g _ 1? 

■■ 

Buffer Address, or jH , if none allocated 


Three-character UIC 

N+3 

First UFD block for this UIC 

N+4 

UFD Entry size for files in this UFD 

Table 5-4 Mass Storage Busy Table Entry 

ADDRESS 

USE 

0 

Stores the contents of the extended PC, link, extend 
mode status, and memory protect status during a pro- 
gram interrupt 

1 

EEM (for PDP-9 compatibility) 

2 

JMP to Skip Chain 

3 

.MED, entry to Monitor Error Diagnostic routine 

4 

JMP to error handler 

5 

Stores system type (Bank or Page) indicator during 
Teletype interrupts 

6 

Used for API ON/OFF indicator 

7 

Stores real time clock count 

10-17 

Autoindex registers 

20 

Stores the contents of the extended PC, link, mode 
status, and memory protect status on a CAL instruc- 
tion. 

21 

JMP to CAL handler 

22-37 

Seven pairs of word counter-current address registers 
for use with 3-cycle I/O device data channels. 

40-77 

Store unique entry instructions for each of 32^ Q auto- 
matic priority interrupt channels 


Table 5-5 Reserved Address Locations 
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5.7 BOOTSTRAP NON-BOSS BATCH BITS 


The high-order three bits of word 17777 in the Bootstrap are reserved 
for the Monitor, and have the following meanings: 

Bit 0 1 = In non-BOSS Batch Mode 

0 = Not in non-BOSS Batch 

Bit 1 1 = $ JOB ASCII line or card just read by batch device 

0 = Last line or card not $JOB 

Bit 2 1 = Batch device is card reader 

2 = Batch device is paper tape reader 
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CHAPTER 6 


FILE STRUCTURES 


6.1 DECTAPE FILE ORGANIZATION 

DECtape can be treated either as a directoried or non-directoried 
device. 

6.1.1 Non-Directoried DECtape 

A DECtape is said to be non-directoried when it is treated as magnetic 
tape by issuing the .MTAPE commands: REWIND, BACKSPACE, followed by 
.READ or .WRITE. No directory of identifying information of any kind 
is recorded on the tape. A block of data (255 ^q word maximum), exactly 
as presented by the user program, is transferred into the handler buf- 
fer and recorded at each .WRITE command. A .CLOSE terminates record- 
ing with a software end-of-file record consisting of two words: 001005, 
776773 

Because braking on DECtape allows for tape roll, staggered recording 
of blocks is employed in DOS to avoid constant turnaround or time- 
consuming back and forth motion of physically sequential block record- 
ing. When recorded as a non-directoried DECtape, block JS5 is the 
first block recorded in the forward direction. Thereafter, every fifth 
block is recorded until the end of the tape is reached, at which time 
recording, also staggered, begins in the reverse direction. Five 
passes over the tape are required to record all 1100 o blocks. 

O 

6.1.2 Directoried DECtape 

Just as a REWIND or BACKSPACE command declares a DECtape to be non- 
directoried, a .SEEK or .ENTER implies that a DECtape is to be con- 
sidered directoried. A directory listing of any such DECtape is 
available via the (L)ist command in PIP. A fresh directory may be 
recorded via the N or S switch in PIP. 

The directory of all DECtapes except system tapes occupies all 400^ 
words of block 100g. It is divided into two sections: (1) a 40g word 
Directory Bit Map and (2) a 340g word Directory Entry Section. 
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The Directory Bit Map defines block availability. One bit is allo- 
cated for each DECtape block (1100 g bits = 40 g words). When set to 1, 
the bit indicates that the DECtape block is occupied and may not be 
used to record new information. 


The Directory Entry Section provides for a maximum of 56.^ files on 
a DECtape. Each file on the DECtape has a four-word entry. Each 
entry includes the three-word file name and extension, a pointer to 
the first DECtape block of the file, and a file active or present bit. 
Figure 6-1 illustrates the DECtape directory. 


Word 



Directory 
Bit Map 


Directory 

Entry 

Section 


Wd. 0 
1 
2 
3 


5 6 


11 12 


17 


File 

Name 


File Name Extension 


Data Link (First File Block) 


Note: Nulls (0) fill 
in short file names. 

A file name extension 
is not absolutely 
necessary . 


Sign Bit: 1 = File Active 
A DIRECTORY ENTRY 


Figure 6-1 
DECtape Directory 

Additional file information is stored in blocks 71 through 77 of every 

director ied DECtape. These are the File Bit Map Blocks. For each file 

in the directory, a 40 fi -word File Bit Map is reserved in block 71 

o th 

through 77. The bit maps are contiguous, and the N file uses the 
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th . 

N bit map. Each block is divided into eight File Bit Map Blocks. A 
File Bit Map specifies the blocks occupied by that particular file and 
provides a rapid, convenient method to perform DECtape storage re- 
trieval for deleted or replaced files. Note that a file is never de- 
leted until the new one of the same name is completely recorded on 
the .CLOSE of the new file. When a fresh directory is written on 
DECtape, blocks 71 through 100 are always indicated in the Directory 
Bit Map as occupied. Figure 6-2 illustrates DECtape file bit maps. 


Block 71g 
Block 72g 

Block 77g 


Figure 6-2 

DECtape File Bit Map Blocks 


Bit 

Map 

for 

File 

0 

Bit 

Map 

for 

File 

7 

Bit 

Map 

for 

File 

8 

Bit 

Map 

for 

File 

15 10 

• 

Bit 

Map 

for 

File 

48 1 9 

Bit 

Map 

for 

File 

56 10 


Staggered recording (at least every fifth block) is used on directoried 
DECtapes, where the first block to be recorded is determined by examina- 
tion of the Directory Bit Map for a free block. The first block is 
always recorded in the forward direction; thereafter, free blocks are 
chosen which are at least five beyond the last one recorded. The last 
word of each data block recorded contains a data link or pointer to 
the next block in the file. When turnaround is necessary, recording 
proceeds in the same manner in the opposite direction. When reading, 
turnaround is determined by examining the data link. If reading has 
been in the forward direction, and the data link is smaller than the 
last block read, turnaround is required. If reverse, a block number 
greater than the last block read implies turnaround. 

A software end-of-file record (001005, 776773) terminates every file. 

The data link of the final block is 777777. 
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Data organization for each I/O medium is a function of the data modes. 

On directoried DECtape there are two forms in which data is recorded: 

(1) packed lines - IOPS ASCII, IOPS Binary, Image Alphanumeric, and 
Image Binary, and (2) dump mode data - Dump Mode. 

In IOPS or Image Modes, each line (including header) is packed into 
the DECtape buffer. In IOPS Binary, a 2's complement checksum is com- 
puted and stored in the second word of the header. When a .WRITE 
which will exceed the remaining buffer capacity is encountered, the 
buffer is output, after which the new record is placed in the empty 
buffer. No record may exceed 254.^ words, including header, because 
of the data link and even word requirement of the header word pair 
count. An end-of-file is recorded on a .CLOSE. It is packed in the same 
manner as any other line. 

In Dump Mode, the word count is always taken from the I/O macro. If 
a word count is specified which is greater than 255 ^q (note that space 
for the data link must be allowed for again) , the DECtape handler will 
transfer 255 ^q word increments into the DECtape buffer and from there 
to DECtape. If some number of words less than 255 ^q remain as the 
final element of the Dump Mode .WRITE, they will be stored in the DEC- 
tape buffer, which will then be filled on the next .WRITE, or with an 
EOF if the next command is .CLOSE. DECtape storage is thus optimized 
in Dump Mode since data is stored back-to-back. See Appendix A. 

6.2 MAGNETIC TAPE 

DOS provides for industry-compatible magnetic tape as either a di- 
rectoried or non-directoried medium. The magnetic tape handlers com- 
municate with a single TC-59D Tape Control Unit (TCU) . Up to eight 
magnetic tape transports may be associated with one TCU; these may 
include any combination of transports TU-10A or B and TU-30A or B. 

There are a number of major differences between magnetic tape and DEC- 
tape or Disk; these differences affect the operation of the device 
handlers. Magnetic tape is well suited for handling data records of 
variable length. Such records, however, must be treated in serial 
fashion. The physical position of any record may be defined only in 
relation to the preceding record. Three techniques available in I/O 
operations to block-addressable devices are not honored by the magnetic 
tape handlers: 
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a. The user cannot specify physical block numbers for 
transfer. In processing I/O requests that have block 
numbers in their argument lists (i.e., .TRAN) the 
handler ignores the block-number specification. 

b. The only area open for output transfers in the direc- 
toried environment is that following the logical end 
of tape. 

c. Only a single file may be open for transfers (either 
input or output) at any time on a single physical unit. 


6.2.1 Non-directoried Data Recording (MTF) 

MTF is intended to satisfy the requirements of the FORTRAN programmer 
while still providing the assembly language programmer maximum freedom 
on the design of his tape format. MTF writes out a record to the tape 
each time the main program issues a .WRITE. The length of the record 
is always two times the word pair count in the header word pair. FIOPS 
records are always as long as the buffer size returned on a .INIT (up 
to 256^^ words). MTF returns a standard buffer size of 377 g, after a 
.INIT. The FORTRAN user may dynamically change this size, however, 
via the following instructions. 


(FORTRAN STATEMENTS) 


CALL SETMTB (ISIZE) 



(MACRO 

STATEMENTS) 


.TITLE 

SETMTB 


. GLOBL 

.DA, MTBSIZ, SETMTB 

SETMTB 

0 



JMS* 

.DA 


JMP 

START 

BUFSIZ 

0 


START 

LAC* 

BUFSIZ (any buffi 


DAC* 

MTBSIZ 


JMP* 

.END 

SETMTB 


6.2.2 Directoried Data Recording (MTA. , MTC.) 


The programmer can make the fullest possible use of those features 
peculiar to magnetic tape by using MTF. On the other hand, MTF does 
not offer the powerful file-manipulation facilities available in the 
system. Directoried I/O allows device independence, and extensive 
use of the storage medium with a minimum of effort. 
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Every block recorded by MTA. (with the exception of end-of-file markers, 
which are hardware-recorded) includes a two-word Block Control Pair 
and not more than 255 -^q words of data. The data will contain the 
records from one or more .WRITE's. 

The Block Control Pair serves three functions: it specifies the char- 
acter of the block (label, data, etc.), provides a word count for the 
block, and gives an 18-bit block checksum. The Block Control Pair has 
the following format: 


Word 1 : 

Bits 0 through 5: Block Identifier (BI). This 6-bit byte 
specifies the block type. Values of BI may range from 0 


to 77 fi . Current legal values 
are as follows: 

BI Value 

00 
10 
20 


of BI , for all user files. 

Block Type Specified 

User-File Header Label 
User-File Trailer Label 
User-File Data Block 


Bits 6 through 17: Block Word Count (BWC) . This 12-bit 
byte holds the 2's complement of the total number of words 
in the block (including the Block Control Pair) . Legal 
values of BWC range from -3 to -40 lg. 


Word 2: 


Bits 0 through 16: Block Checksum. The Block Checksum is 
the full-word, unsigned, 2's complement sum of all the 
data words in the block and word 1 of the Block Control 

Pair. 


0 5 6 


t 7 





> 


N TOTAL WORDS 
IN BLOCK 


Figure 6-3 


Block Format, File-Structured Mode 
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One of the main file functions of MTA. and MTC. is that of identifying 
and locating referenced files. This is carried out by two means: 
first, names of files recorded are stored in a file directory at the 
beginning of the tape; and second, file names are contained in the 
file's header and trailer labels. 

6. 2. 2.1 Magnetic Tape File Directory 


The directory, a single-block file (and the only unlabeled file on any 
file-structured tape) , consists of the first recorded data block on 
the tape. It is a 257 word block with the following characteristics: 


a. Block Control Pair (words 1 and 2) 

Word 1 

Block Identifier = 74 0 = File Directory Data Block 

O 

Block Word Count = -401g = 7377g. 

Word 2: 

Block Checksum: As described above. 

b. Active File Count (Word 3, Bits 9 through 17) 9-bit one's 
complement count of the active file names present in the 
File Name Entry Section (described below) . 

c. Total File Count (Word 3, Bits 0 through 8) 9-bit one's 
complement count of all files recorded on the tape, in- 
cluding both active and inactive files, but not the file 
directory block. 

d. File Accessibility Map (Words 4 through 17) : The File 
Accessibility Map is an array of 252 -^q contiguous bits 
beginning at bit 0 of word 4 and ending as bit 17 of 
word 17. Each of the bits in the Accessibility Map re- 
fers to a single file recorded on tape. The bits are 
assigned relative to the zero^ file recorded; that is, 
bit 0 of word 4 refers to the first file recorded; bit 
1, word 4, to the second file recorded; bit 0, word 6, 
to the 37iQ th file recorded; and so on, for a possible 
total of 252^ files physically present. 

A file is only accessible for reading if its bit in the 
Accessibility Map is set to one. A file is made inac- 
cessible for reading (corresponding bit =0) by a .DLETE 
of the file, by a .CLOSE (output) of another file of the 
same name, or by a .CLEAR. A file is made accessible for 
reading (corresponding bit =1) by a .CLOSE (output) of 
that file. Operations other than those specified above 
have no effect on the File Accessibility Map. 
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WORD 1 7 

BCP -k 

I WORD 2 

FILE COUNTS WORD 3 7 

f""" WORD 4 01011 


BIT POSITION 
6 9 12 15 17 


BLOCK CHECKSUM 


BEGINNING 
OF TAPE 


F I LE 

D I RECTORY 


FILE 

ACCESSI B I L I TY 
MAP 


FILE 
NAME 
ENTRY 
SECTI ON 


WORD 1 6 

WORD 1 7 

WORD 18 


CONTENTS 
UNSPEC IFIEO 


F 

I 

L 

E 

# 

2 

E 

X 

T 

F 

I 

L 

E 

# 

4 

E 

X 

T 

F 

I 

L 

E 

# 

5 

E 

X 

T 


FILE #1 
(I NACTI VE) 


FILE #2 
(ACTIVE) 


FILE #3 
(INACTIVE) 


FILE #4 
( ACTI VE) 


FILE #5 
(ACTIVE) 


C ON TENTS 
UNSPEC I F I ED 


WORD 257 


END OF TAPE 


Figure 6 -4a. Format of the 
File Directory Data Block, 
showing relationship of active 
and inactive files to file name 
entries and to Accessibility Map 


Figure 6-4b. Format of file- 
structured tape, showing 
directory block and data 
files . 









e. File Name Entry Section (Words 18 through 257): The File 
Name Entry Section, beginning at word 18 of the direc- 
tory block, includes successive 3-word file name entries 
for a possible maximum of 80 entries. Each accessible 
file on the tape has an entry in this section. Entries 
consist of the current name and extension of the refer- 
enced file in .SIXBT (left-adjusted and, if necessary, 
zero-filled) . 

The position of a file name entry relative to the begin- 
ning of the section reflects the position of its accessi- 
bility bit in the map. That bit, in turn, defines the 
position of the referenced file on tape with respect to 
other (active or inactive) files physically present. Only 
active file names appear in the entry section, and access- 
ibility bits for all inactive files on the tape are always 
set to zero; accessibility bits for all active files are 
set to one. 

To locate a file on the tape having a name that occupies 
the second entry group in the File Name Entry Section, 
the handler must (a) scan the Accessibility Map for the 
second appearance of a 1-bit, then (b) determine that bit's 
location relative to the start of the map. That location 
specifies the position of the referenced file relative to 
the beginning of the tape. The interaction of the File 
Name Entry Section and the Accessibility Map are shown 
in Figure 6-4. 


6. 2. 2. 2 User-File Labels 


Associated with each file on tape is one label, the header label. It 
precedes the first data block of the file. Each label is 27-^ words 
in length. Label format is shown in Figure 6-5. 


0 5 6 17 



Figure 6-5 


User-File Header Label Format 
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6. 2.2. 3 File-Names in Labels 


The handler will supply the contents of the file-name fields (Word 3) 
in labels. These are used only for control purposes during the execu- 
tion of .SEEK's. The name consists simply of the two's complement of 
the position of the recorded file's bit in the Accessibility Map; the 
"name" of the first file on tape is 777777, that of the third file is 
777775, and so on. A unique name is thus provided for each file physi- 
cally present on the tape. Since there may be a maximum of 252.^ files 
present, legal file-name values lie in the range 777777 to 777404. 

6.2.3 Continuous Operation 


Under certain circumstances, it is possible to perform successive I/O 
transfers without incurring the shut-down delay that normally takes 
place between blocks. The handler stacks transfer requests, and thus 
ensures continued tape motion, under the following conditions: 


a. The I/O request must be received by the CAL handler be- 
fore a previously-initiated I/O transfer has been com- 
pleted. 

b. The unit number must be identical to that of the pre- 
viously initiated I/O transfer. 

c. The I/O request must be one of those listed below to 
ensure successful completion. The handler in process- 
ing requests in continuous mode depends on receiving 
control at the CAL level in order to respond to I/O 
errors. The functions for which continuous operation 
is attempted include only the following: 

1. . MTAPE 3. .WRITE 

2 . . READ 4 . . TRAN 

d. With MTA , more than one logical record may be in a physical 
block, so tape motion may stop if fewer successive .READ'S 
or .write's are issued than there are records in a block. 

e. The previously-requested transfer must be completed with- 
out error. In general, successive error-free READ'S 
(WRITE's) to the same transport will achieve non-stop 

The following examples illustrate this prin- 


Successful Continued Operation 


.TRAN SLOT, INPUT, BLOCKNO , BUFFI, 257 
.TRAN SLOT, INPUT, BLOCKNO, BUFF 2 , 257 
JMP READ1 


operation . 
ciple . 

Example 1: 

SLOT = 1 
INPUT = 0 
BLOKNO = 0 
READl 
READ2 
RETURN 
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The program segment in Example 1 will most probably keep the refer- 
enced transport (.DAT slot 1) up to speed. The probability decreases 
as more time elapses between READ1 and READ2 , and between READ2 and 
RETURN. Each .TRAN request causes an implicit .WAIT until its opera- 
tion is completed. 


Example 2: Unsuccessful Continued Operation 


SLOT = 1 
INPUT = 0 
BLOKNO = 0 

READ .TRAN SLOT, INPUT, BLOKNO, BUFF, 257 

STOP .WAIT SLOT 

RETURN JMP READ 


The program segment in Example 2 will not keep the tape moving because 
the .WAIT at location STOP prevents control from returnina to location 
READ until the transfer first initiated at READ has been completed. 


Example 3: Unsuccessful Continued Operation 


SL0T1 = 1 
SL0T2 = 2 
INPUT = 0 
BLOKNO = 0 
READl 
READ 2 
RETURN 


.TRAN SLOTl , INPUT, BLOKNO, BUFFI, 257 
.TRAN SL0T2 , INPUT, BLOKNO, BUFF 2 , 257 
JMP READl 


This program segment will not provide non-stop operation because of 
the differing unit specification at READl and READ 2 . 

6.2.4 Storage Retrieval on File-Structured Magnetic Tape 

The use of a file accessibility map as well as block identifiers in 
Magtape file directories makes it almost impossible to retrieve the 
area of a deleted file from a magnetic tape. The execution of the 
deletion command (i.e., . DLETE ) removes the name of the object file 

from the file directory, and clears the corresponding bit in the File 
Accessibility Map. 


The only circumstance under which a file area may be easily retrieved 
is when the deleted file is also the last file physically on the tape. 
Under these conditions, the handler can retrieve the area occupied by 
the deleted file when the next .ENTER - .WRITE - .CLOSE sequence is 
executed. Users may also copy the active files to another device, re- 
new the directory, and recopy the files. 
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6.3 DISK FILE STRUCTURE 


6.3.1 Introduction 

The DOS-15 disk file structure is in some ways analogous to DECtape 
file structure. Ordinarily, each disk user has a directory which 
points to named files, just as each DECtape has a directory. The DEC- 
tape has only one directory, but the disk has as many directories as 
users have cared to establish. A single user's disk directory might 
correspond to a single DECtape directory. A single disk file's size 
is also limited only by the available space, as is true with DECtape. 
Whereas DECtape directories may only reference a maximum of 56-^ files 
however, the number of files associated with any one directory on the 
disk is limited only by the available disk space. 

The DECtape directory is in a known location -- at block 100. Since 
the disk may have a variable number of directories, the Monitor must 
know how to find each user's directory. It therefore maintains a 
Master File Directory (MFD) at a known location 1 , and the Master File 
Directory points to each User File Directory (UFD) . DOS-15 allows 
only those users who know the Master Identification Code to have ac- 
cess to any protected UFD ' s within the MFD. Figure 6-6 illustrates 
the MFD. Appendix B is a flowchart of the Disk "A" Handlers. 

6.3.2 User Identification Codes (UIC) 

The Monitor finds User File Directories by seeking associated User 
Identification Codes (UIC's), which are all listed in the Master File 
Directory. The UIC is a three-character code that is necessary for 
all non-. TRAN I/O to the disk. .TRAN macros use no directory refer- 
ences. A programmer may operate under as many UIC's as he wishes, pro 
vided all are unique and none is reserved 2 . He may establish a new 
User File Directory by (1) logging in his new UIC to the Monitor via 
the LOGIN command, (2) calling PIP, and (3) issuing an N DK command. 
This establishes a new User File Directory, or refreshes (wipes clean) 
an old directory under that UIC. (.ENTER will also create a new MFD 
entry and/or a UFD, if none exists.) Figure 6-7, User File Directory, 
illustrates the organization of a UFD. 


2 0n the RF disk, the first block of the MFD is located at block 1777. 
On the RP disk, the first block of the MFD is located at block 47)240 . 

2 The following are reserved UIC's: @@@, ???, PAG, BNK, SYS, IOS, 

CTP . 
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Word # 


Contents 


Description 


j L 


0 

min 

Dummy UIC used by system. 

1 

nnnnnn 

Bad Allocation Table's first block number, 
or 777777, if there is none. ‘ 

2 

nnnnnn 

SYSBLK's first block number, or -1, if 
there is none. 

3 

4 „ „+blknum 

0-2 

MFD entry size in bits 0-2, plus the block 


number of the first submap 

4N 

. S IXBT 

UIC for this UFD 

4N+1 

nnnnnn 

Block number for the first block of this 

UFD or 777777, if no UFD exists (as after 

PIP'S NljDK,)) 

4N+2 

V M 

Protection code in bit 0, plus the UFD 
entry size for each file 

4N+3 

spare 

Unused at this writing 

376 

nnnnnn 

Pointer to previous MFD block, or 777777 
if no ne . 

377 

nnnnnn 

Pointer to next MFD block, or 777777 if 
none. 


Figure 6-6 


Master File Directory 


Word # 

Contents 

Description 

8N 

. SIXBT 

Name of this file 

8N+1 

. SIXBT 

and its 

8N+2 

.SIXBT 

extension 

8N+3 

T rt ^-blknum 

0 

Truncation code in bit 0 , plus the number 
of tire first block of the file 

8N+4 

nnnnnn 

Number of blocks in this file 

8N+5 

ribptr 

Pointer to the first block of the Retrieval 
Information Block 

8N+6 

P^_ 1 +ribwrd 

Protection code in bits 0 - 1 , plus the 
first word in ribptr used by the RIB — if 
the last block of the file has room for 
the RIB, the handlers will put it there, 
and load word 8N+6 accordingly. 



8N+7 

crdate 

Date of file's creation -mmddyy (yy modulo 10 ) 

376 

nnnnnn 

Pointer to previous block, or 777777 if none 

377 

nnnnnn 

Pointer to next UFD block, or 777777 if none 



Figure 6-7 


User File Directory 
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6.3.3 Organization of Specific Files on Disk 


The Disk Handlers write out files in almost the same way that a DEC- 
tape handler does. Disk file blocks, however, have a forward and 
backward link. (Non-dump records are therefore limited to lengths 
of 254 ^q words.) Further, upon receipt of a .CLOSE I/O macro, the disk 
handlers fill out a Retrieval Information Block (RIB) . The RIB per- 
forms the same functions as the file bitmap on DECtape, and also as- 
sociates the logical sequence of blocks in the file with the physical 
locations of the blocks on the disk. The disk handler uses the RIB to 
implement . RTRAN commands and to delete files. Figure 6-8, The Retrieval 
Information Block, illustrates a RIB. 

After a user has created a disk file he can access logical records 
sequentially via .READ commands, just as with DECtape files. He can 
also access physical blocks of that file by referencing relative block 
numbers in the .RTRAN command. (The .RTRAN commands require the file 
be opened with the .RAND command.) 

6.3.4 Buffers 

The handlers break buffers from the pool into three parts: (1) File 
Information (about 4j? 0 words)* (2) the Block List — addresses of 

O 

pre-allocated blocks (between 4 and 253^ addresses, inclusive), and 
(3) data buffer (256^ words). Figure 6-9, Disk Buffer, illustrates 
the breakdown of disk buffers. 

6. 3.4.1 Commands That Obtain And/or Return Buffers 

The following commands obtain buffers from the pool, and return them 
immediately after execution: 

. DLETE 
.RENAM 
.CLEAR 

The following commands obtain a buffer from the pool and do not return 
it until a subsequent .CLOSE is performed: 

. FSTAT 
.ENTER 
.SEEK 
.RAND 


*This number is determined by assembly parameters. 
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Word # 

Contents 

Description 

0* 

nnnnnn 

Total number of blocks described by this 
physical block. 

1 

nnnnnn 

First data block pointer. 

2 

nnnnnn 

Second data block pointer. 

3 

nnnnnn 

Third data block pointer. 

376 

nnnnnn 

Pointer to previous RIB block or -1 if no 
previous RIB block. 

377 

nnnnnn 

Pointer to next RIB block or -1 if no 
next RIB block. 

* Zero*'* 1 word of the RIB may not be zero** 1 word of physical block. 

This occurs whenever the entire RIB will fit in the last data 

block of 

the file. 



Figure 6-8 

Retrieval Information Block 


40 o Words* 

i 

More than 3 and 
less than 377g 
words 


400g Words 

' 


> 


y 


File Information becomes 
'Current Set' when file active 
Csee 6 . 3 . 4 . 2 ) . 


Addresses of Preallocated 
Blocks (Block List or Temp 
List or TLIST) 


Data Buffer 


*This is not a fixed number. It is 
different for RP and RF. 


Figure 6-9 
Disk Buffer 
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The following commands return a buffer to the pool, if any was allo- 
cated. 

. INIT 
.CLOSE 

. MTAPE (rewind) 

6. 3.4.2 The Current Set 

The handlers retain information about the last file and .DAT slot 
processed in an internal storage area. This area is called the 
"Current Set", and is swapped back to the file's buffer whenever a 
command to a different file is used. Thus, 

.WRITE to .DAT slot A 
.WRITE to .DAT slot B 

will swap the Current Set, but... 

.WRITE to .DAT slot A 
.TRAN to .DAT slot A 
.WRITE to .DAT slot A 

will not swap the Current Set. 

6.3.5 Pre-allocation 

The handlers pre-allocate blocks on the disk upon all .ENTER commands, 
and whenever sufficient .WRITE commands have been issued to use up the 

pre-allocated blocks. The number of pre-allocated blocks will be the 
minimum of the number of free blocks on the device and the number of 
address slots available in the Temp List (block list) . 

When the handlers pre-allocate blocks, they fill out the bit maps, and 
immediately fill out the RIB and write it out in one of the pre-allocated 

blocks . 

Upon a .CLOSE command, the handlers give back unused blocks, and re- 
write the RIB. 
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The number of blocks in the Block List depends on the size of the 
buffer, which is determined at system generation by setting the buffer 
size. The larger the Block List, the faster will be output. Smaller 
Block Lists may give more efficient allocation of core and disk space. 
Smaller buffers save core. Further, the number of pre-allocated blocks 
may affect concurrently opened files on a disk that is tight for space. 
Thus, if the Block List is sixty entries long, and there are forty 
blocks left on the disk, a .ENTER to .DAT slot will pre-allocate all 
forty, leaving none for any subsequent .ENTER's to different .DAT 
slots . 

IOPS 70 will occur when there are less than four free blocks on the 
disk when a handler tries to pre-allocate blocks. 


6.3.6 Storage Allocation Tables (SAT's) 

The disk handlers use a Storage Allocation Table, in order to distin- 
guish between allocated and free blocks. If more than one physical 
block is required, the individual blocks are called Submaps. 

Unlike DECtape , the Storage Allocation Table is never held in core. 
When the handlers wish to preallocate some blocks, they read in the 
required Submap, and write out the updated one. 

Storage Allocation blocks use the following format: 


WORD 

0 

Total blocks on the disk 

WORD 

1 

Number of blocks described 
by this Submap 

WORD 

2 

Number of blocks occupied 
in this Submap 

WORD 

3 

First word of the bit map 
(eighteen blocks per word) 

WORD 

376 

Pointer to previous Submap 
(or 777777) 

WORD 

377 

Pointer to next Submap 


(or 777777) 

The bit maps refer to blocks in numerical order. Thus, bit 0 of word 
three of a Submap will refer to block N, bit 1 will refer to block N+l, 
and so on. The block is free if the corresponding bit equals 0 . Start- 
ing and ending block numbers for all Submaps are retained in the hand- 
lers. The first Submap, however, starts with block zero. 
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6.3.7 Bad Allocation Tables (BAT's) 


Occasionally, a particular block on the disk will not record data cor- 
rectly. In such instances, the handlers should be prevented from using 
the bad blocks. Accordingly, PIP maintains a Bad Allocation Table. 
Whenever a user updates that table, PIP will set the appropriate bit 
in the Storage Allocation Table. The block is thus made unavailable. 
Refer to pip manual (DEC-15 -vwZB-DNl 3 ) for more information. 
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CHAPTER 7 


WRITING NEW I/O DEVICE HANDLERS 


This chapter contains information essential for writing new I/O de- 
vice handlers to work in DOS. 

7.1 I/O DEVICE HANDLERS, AN INTRODUCTION 

All communications between user programs and I/O device handlers are 
made via CAL instructions followed by an argument list. The CAL 
Handler in the Monitor (Figure 2-1) performs preliminary setups, 
checks the CAL calling sequence, and transfers control via a JMP* 
instruction to the entry point of the device handler. When the con- 
trol transfer occurs (see Figures 7-1 and 7-2) , the AC contains the 
address of the CAL in bits 3 through 17 and bits 0, 1, and 2 indicate 
the status of the Link, Bank/Page mode, and Memory Protect, respect- 
ively, at the time of the CAL. Note that the content of the AC at 
the time of the CAL is not preserved when control is returned to the 
user. 

On machines that have an API, the execution of a CAL instruction auto- 
matically raises the priority to the highest software level (level 4) . 
Control passes to the handler while it is still at level 4, allowing 
the handler to complete its non-reentrant procedures before debreaking 
(DBK) from level 4. This permits the handler to receive reentrant 
calls from software levels higher than the priority of the program 
that contained this call. Device handlers which do not contain re- 
entrant procedures (including all handlers supplied with DOS) may avoid 
system failure caused by inadvertent reentries by remaining at level 
4 until control is returned to the user. 

If the non-reentrant method is used, the debreak and restore (DBR) 
instruction should be executed just prior to the JMP* which returns 
control to the user, allowing debreak from level 4 and restoring the 
conditions of the Link, Bank/Page mode, and Memory Protect. Any IOT's 
issued at the CAL level (level 4 if API present, mainstream if no API) 
should be executed immediately before the 

DBR 

JMP* 
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CAL Entry to Device Handler 

Figure 7-1 














PI API 

ENTRY — via ENTRY — via 



PI and API Entries to Device Handlers 

Figure 7-2 
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exit sequence in order to ensure that the exit takes place before the 
interrupt from the issued IOT occurs. 


The CAL instruction must not be used at any level (API or PIC) that 
might interrupt a CAL. A CAL at such a level will destroy the content 
of location 00020 for the previous CAL. 


Care must also be taken when executing CALs at level 4. For example, 
a routine that is CALed from level 4 must know that if a debreak (DBR 
or DBK) is issued, control will return to the calling program (which 
had been at level 4) at a level lower than level 4. 

7.1.1 Setting Up the Skip Chain and API (Hardware) Channel Registers 

When the Monitor is loaded, the Program Interrupt (PI) skip chain and 
the Automatic Priority Interrupt (API) channels are set up to handle 
the TTY keyboard and printer and clock interrupts only. The Skip 
Chain contains the other skip IOT instructions, but indirect jumps to 
an error routine result if a skip occurs, as follows: 


SKPDTA 

SKP 

JMP* INTI 
SKP LPT 
SKP 

JMP* INT2 

SKPTTI 

SKP 

JMP TELINT 


/Skip if DECtape flag. 

/INTI contains error address. 
/Skip if line printer flag. 

/INT2 contains error address. 
/Skip if teleprinter flag. 

/To teleprinter interrupt handler 


All unused API channels, memory protect, memory parity, and powerfail, 
also contain JMP's to the error address. 

When a device handler is called for the first time in a core load, it 
must call a Monitor routine (.SETUP) to set up its skip(s) in the Skip 
Chain, or its API channel, prior to performing any I/O functions. 
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The calling sequence is as follows: 


CAL N 


16 

SKP IOT 
DEVINT 

(normal return) 


/N = API channel register 40 through 77 (see User ' s 
Handbook Vol. 1 , for standard channel assign- 
ments ) , 

/0 if device not connected to API. 

/.SETUP function code. 

/Skip IOT for this device. 

/Address of interrupt handler. 


7.1.2 Handling the Interrupt 


DEVINT exists in the device handler in the following format to allow 
for either API or PI interrupts. 


ONLYl 


DEVPIC 


DEVINT 


IGNRPI 


COMMON 

DEVION 


LAC 

DAC 

DAC 

DAC 

JMP 

DAC 

LAC* 

DAC 

JMP 

JMP 

DAC 

LAC 

DAC 

JMP 


DEVCF 

ION 


(NOP 
DEVION 
DEVI OF 
IGNRPI 
COMMON 
DEVAC 
(0 

DEVOUT 

COMMON 

DEVPIC 

DEVAC 

DEVINT 

DEVOUT 

ONLYl 


/LEAVE PI ALONE , WHEN API IS RUNNING 

/THESE REGISTERS 

/ARE AVAILABLE 

/THIS IS ONCE ONLY CODE 

/SAVE AC 

/SAVE PC, LINK, ADDRESSING MODE AND 
/MEMORY PROTECT 

/PI ENTRY 

/API ENTRY; SAVE AC 

/SAVE PC, LINK, ADDRESSING MODE AND 
/API IS OPERATING, SO LEAVE PI ALONE. 
/PI INTERRUPTS ARE NOT POSSIBLE, BE- 
CAUSE .SETUP EFFECTIVELY NOP ' S PI 
/SKIPS . 

/CLEAR DEVICE DONE FLAG. 

/PI ALLOWS INTERRUPTS; API DOES A NOP. 


DEVIOF 

I OF 


DEVIOT 


/API DOES NOP; PI TURNS 10 OFF TO ENSURE 
/NON-REENTRANCE AFTER ISSUING IOT ' S . 


/DISMISS ROUTINE 


DVSWCH 

LAC 

ION 

DEVAC 

/RESTORE AC. 

/ION OR NOP . 



DBR 

JMP* 

DEVOUT 

/DEBREAK AND RESTORE 
/OF LINK, ADDRESSING 

CONDITIONS 

MODE AND MEMORY 


/PROTECT. 


If the Index, Autoincrement, or EAE registers are used by the I/O de- 
vice handler, it is necessary to save and restore them. 
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.SETUP allows either API or PI, but not both for a single device. The 
System Generator Manual gives the method for incorporating new handlers 
and associated Skip Chain entries into the Monitor. 

7.2 API SOFTWARE LEVEL HANDLERS, An Introduction 

The information presented in the following paragraphs assumes that the 
reader is familiar with the system input/output considerations described 
in the PDP-15 User's Handbook Vol. 1. 


7.2.1 Setting Up API Software Level Channel Registers 


When the Monitor is loaded, the API software-level channel registers 
(40 through 43) are initialized to 


JMS * 

.SCOM+12 

/LEVEL 

4 

JMS* 

.SCOM+1 3 

/LEVEL 

5 

JMS* 

.SCOM+1 4 

/LEVEL 

6 

JMS* 

. SCOM+15 

/LEVEL 

7 


where .3COM is equal to absolute location 000100 and .SCOM+12 through 
. SCOM+1 5 (000112 through 000115) each contains the address of an error 
routine . 


Therefore, prior to requesting any interrupt at these software priority 
levels, the user must modify the contents of the .SCOM registers so 
that they point to the entry point of the user's software level handlers. 


Example: 


. SCOM=100 

LAC (LV5INT / set level 5 entry. 

DAC* (.SCOM+1 3 


LV5INT exists in the user's area in the following format: 

LV5INT 0 /PC, LINK, BANK/PAGE MODE , MEM. PROT . 

DAC SAV4AC /SAVE AC 

/SAVE INDEX, AUTOINCREMENT AND EAE REGISTERS, IF LEVEL 5 
/ROUTINES USE THEM AND LOWER LEVEL ROUTINES ALSO USE THEM. 
/SAVE MQ AND STEP COUNTER, IF SYSTEM HAS EAE AND IT IS USED 
/AT DIFFERENT LEVELS. 


/RESTORE SAVED REGISTERS. 

DBR /DEBREAK FROM LEVEL 5 AND RESTORE 

JMP* LV5INT /L, BANK/PAGE MODE, MEM. PROT. 
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7.2.2 Queueing 


High priority/high data rate/short access routines cannot perform com- 
plex calculations based on unusual conditions without holding off 
further data input. To perform the calculations, the high priority 
program segment must initiate a lower priority (interruptable ) segment 
to perform the calculations. Since many data handling routines would 
generally be requesting calculations, there will exist a queue of cal- 
culation jobs waiting to run at the software level. Each data handling 
routine must add its job request to the appropriate queue (taking care 
to raise the API priority level as high as the highest level that 
manipulates the queue before adding the request) and issue an interrupt 
request (ISA) at the corresponding software priority level. The general 
flow chart. Figure 7-4, depicts the structure of a software handler 
involved with queued requests. 

Care must be taken about which routines are called when a software 
level request is honored; that is, if a called routine is "open" 

(started but not completed) at a lower level, it must be reentrant, or 
errors will results. 


NOTE 

The DOS hardware I/O device handlers do not 
contain reentrant procedures and must not be re- 
entered from higher levels. 

Resident handlers for Power Fail, Memory Parity, 
nonexistent memory violation, and Memory Protect 
violation have been incorporated into the system 
and effect an IOPS error message if the condition 
is detected. The user can, via a .SETUP, tie his 
own handler to these skip IOT or API channel regis- 
ters . 
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LV5INT 



15-0094 


Figure 7-4 

Structure of API Software Level Handler 
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7.3 WRITING SPECIAL I/O DEVICE HANDLERS 


This section contains information prepared specifically to aid those 
users who plan to write their own special I/O device handlers for DOS. 

DOS is designed to enable users to incorporate their own device hand- 
lers. Precautions should be taken when writing the handler however, 
to ensure compatibility with the Monitor. 

Here is a summary of handler operation. The handler is entered via a 
JMP* from the Monitor as a result of a CAL instruction. The contents 
of the AC contain the address of the CAL in bits 3 through 17. Bit 0 
contains the Link, bit 1 contains the Bank/Page Mode status, and bit 2 
contains the Memory Protect status. The previous contents of the AC 
and Link are lost. 

In order to show the steps required in writing an I/O device handler, 
a complete handler (Example B) was developed with the aid of a skeleton 
handler (Example A). In addition. Appendices A and B are complete 
flowcharts of the DTA and DKA handlers. The skeleton handler 
is a non-reentrant type (discussed briefly at the beginning of this 
chapter) and uses the Debreak and Restore Instruction (DBR) to leave 
the handler at software priority level 4 or at a hardware level for 
interrupt servicing (if API), and restore the status of the Link, 
Bank/Page Mode, and Memory Protect. Example A is referenced by part 
numbers to illustrate the development of Example B, a finished Analog- 
to-Digital Converter (ADC) I/O Handler. The ADC handler shown in 
Example B was written for the Type AF01B Analog to Digital Converter. 
This handler is used to read data from the ADC and store it in the 
user's I/O buffer. 

The reader, while looking at the skeleton of a specialized handler 
as shown in Example A, should make the following decisions about his 
own handler. (The decisions made in this case are in reference to 
developing the ADC handler) : 

a. Services that are required of the handler (flags, 
receiving or sending of data, etc.) -' By looking 
at the ADC IOT's shown in the Reference Manual, it 
can be seen that there are three IOT instructions 
to be implemented. These instructions are: Skip 
if Converter Flag Set, Select and Convert, and Read 
Converter Buffer. 
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The only service the ADC handler performs is that of 
receiving data and storing it in user specified areas. 
This handler will have a standard 256-word buffer. 

b. Data Modes used (for example, IOPS ASCII, etc.) - 
Since there is only one format of input from the 
Type AFOlB ADC, mode specification is unnecessary in 
Example C. 

c. Which I/O macros are needed for the handler's specific 
use; that is, . INIT , .CLOSE, .READ, etc. For an ADC, 
the user would be concerned with four of the macros. 

(1) .INIT would be used to set up the associ- 
ated API channel register or the interrupt 
skip IOT sequence in the Program Interrupt 
Skip Chain. This is done by a CAL (N) as 
shown in Part III of Example A, where (N) 
is the channel address. 


(2) .READ is used to transfer data from the ADC. 

When the .READ macro is issued, the ADC 
handler will initiate reading of the speci- 
fied number of data words and then return 
control to the user. The analog input data 
received is in its raw form. It is up to 
the programmer to convert the data to a 
usable format. 

(3) .WAIT detects the availability of the user's 
buffer area and ensures that the I/O trans- 
fer is completed. It would be used to ensure 
a complete transfer before processing the re- 
quested data. 

(4) . WAITR detects the availability of the user's 
buffer area as in (3) above. If the buffer 
is not available, control is returned to a 
user specified address, which allows other 
processing to continue. 

d. Implementation of the API or PIC interrupt service routine 
Example A shows an API or PIC interrupt service routine 
that handles interrupts, processes the data and initi- 
ates new data requests to fully satisfy the .READ macro 
request. Note that the routines in Example A will oper- 
ate with or without API. Example B uses the routines 
exactly as they are shown in Example A. 

During the actual writing of Example B, consideration was 
given to the implementation of the I/O macros in the new 
handler in one of the following ways: 

(1) Execute the function in a manner appropriate 

to the given device as discussed in(c). .INIT, 

.READ, .WAIT, and .WAITR were implemented into 
the ADC handler (Example B) under the subroutine 
names ADINIT, AD RE AD, AD WAIT (.WAIT and .WAITR). 

Wait for completion of previous I/O. (Example B 
shows the setting of the ADUND switch in the ADREAD 
subroutine to indicate I/O underway.) 
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(2) Ignore the function if meaningless to the device. 
See Example B (.FSTAT results in JMP ADIGN2) in 
the dispatch table DSPCH. For ignored macros, 
the return address must be incremented in some 
cases, depending upon the number of arguments 
following the CAL (see Chapter 3) . 

(3) Issue an error message in the case where it is 
not possible to perform the I/O function - (An 
example would be trying to execute a .ENTER on 
the paper tape reader. ) In Example B, the handler 
jumps to DVERR6 which returns to the Monitor with 
a standard error code in the AC. 


After the handler has been written and assembled, the Monitor must then 
be modified to recognize the new handler. This is accomplished by the 
use of the System Generator Program (DOSGEN) described in the DEC- 
15-YWZB-DN12 manual. 


W!ien the system generation is complete, the PIP program (refer to 
DEC-15-YWZA-DN13) must be used to add the new handler to the IOS UFD. 
At this time, the user is ready to use his specialized device handler 
in the DOS-15 system. 

7.3.1 Discussion of Example A by Parts 


Part 1 Stores CAL pointer and argument pointer, and 
picks up function code from argument string. 

Part 2 By getting proper function code in Part 1 and 
adding a JMP DSPCH, the CAL function is dis- 
patched to the proper routine. 

Part 3 This is the .SETUP CAL used to set up the PI 
skip chain or the API channel register. 

Part 4 Shows the API and PI handlers. It is suggested 
these be used as shown. 

Part 5 This area reserved for processing interrupt and 
performing any additional I/O. 

Part 6 Interrupt dismiss routine. 

Part 7 Increments argument pointer in bypassing argu- 
ments of ignored macro CAL's. 
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Example 

A, Skeleton I/O Device Handler 

/cal entry routine 



. globl 

DEV, 

/MUST BE OF FORM AAA, 

,ME0»3 



/ 1 MED (MONITOR ERROR DIAGNOSTIC) 

DEV, 

OAC 

DVCALP 

/SAVE CAL POINTER 


OAC 

DVARGP 

/AND ARGUMENT POINTER 


IS2 

DVARGP 

/points to function code 


LAC» 

DVARGP 

/GET CODE 


AND 

(77777 

/REMOVE UNIT NO IF APPLICABLE 


i$z 

DVARGP 

/POINTS TO CaL*2 


TAD 

(JMP DSPCH 



OAC 

DSPCH 

/DISPATCH WITH 

DSPCH 

XX 


/modified jump 


JMP 

DVINIT 

/I ■ i 1 N I T 


JMP 

OVFSAT 

/2 « » FSTAT » i DLETE , ,RENAM 


JMP 

DVSEEK 

/3 « .SEEK 


JMP 

DVENTR 

/4 = .ENTER 


JMP 

DVCLER 

/5 » .clear 


JMP 

OVCLOS 

/6 « .close 


JMP 

DVMTAP 

/7 a .MTAPE 


JMP 

DVREAD 

/10 ■ .READ 


JMP 

dvwrte 

/II a .WRITE 


JMP 

OVWAIT 

/12 a .WAIT 


JMP 

DVTRAN 

/13 « , TR AN 

/illegal functions in above 

table coded AS 1 

/ 

JMP 

DVERR6 


/FUNCTION CODE 

ERROR 


OVERR6 

law 

6 

/ERROR CODE 6 


JMP* 

( t MED*1 

/TO MONITOR 

/OATA MODE ERROR 


OVERR7 

law 

7 

/ERROR CODE 7 


JMP* 

( ,MED*1 

/TO MONITOR 

/DEVICE 

NOT READY 


DVERR4 

lac 

(RETURN 

/RETURN (ADDRESS IN HANDLE*) 

/TO RETURN To WHEN NOT READY 
/condition has been removed 


DAC* 

( i MED 



lac 

(4 

/ERROR CODE 4 


JMP* 

( . MED*1 

/TO MONITOR 

/ J/O UNDERWAY 

LOOP 


OV8USY 

obr 


/BREAK FROM lEVEl 4 


jMP* 

DVCALP 

/LOOP ON CAL 

/NORMAL 

RETURN 

FROM CAL 


OVCK 

obr 


/BREAK FROM LEVLE 4 


JMP* 

OVARGP 

/RETURN AFTER CA L AND 


/ARGUMENT string 


/THE DVInIT ROUTINE MUST INCLUDE 
/A .SETUP CALLING SEQUENCE F OR 
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/EACH FLAG CONNECTED TO API 
/AND/OR PJ A e AT SGEN TIME) , 

/the setup calling sequence i s i 


DVINIT 

cal 

N 

/N s API channel register 




/<40 -77), N s 0 JF NOT CONNECTei 




/TO API 


16 


/IOps function code 


SKPIO.T 


/SKIP i o t to test the flag 


OBVImT 


/ADDRESS OF INTERRUPT 




/HANDLER (PI OR API) 

/THIS : 

SPACE MAY 

BE USED FOR 

I/O SUBROUTINES 

/INTERRUPT HaNDL 

,ER FOR API 

OR PI 

onlyi 

lac 

(NOP 



DAC 

DEV I ON 



OAC 

DEV I OF 



DAC 

DVSWCH 



DAC 

I GNRP I 



JMP 

COMMON 


DVPIC 

DAC 

pevac 

/SAVE AC 


lac« 

( 3 

/SAVE 1 PC , LINK, RANK/PAGE MODE 


DAC 

DVOUT 

/AND MEMORY PROTECT 


JMP 

COMMON 


0 V I NT 

JMP 

DEVPIC 

/PI entry 


DAC 

DEVAC 

/API ENTRYI SAVE AC 


lac 

DEV I NT 

/savei pc. Link, bank/page mode 


DAC 

DEVOUT 

/memory protect 

IGNRPJ 

JMP 

ONLYI 

/LEAVE pi aLone 

common 

devcf 


/enable pi or nop 

DEV I ON 

ION 


/enable pi or nop 

/THIS 

A I THE are a devoted 

to PROCESSING INTERRUPT AND 

/PERFORMING AMY 

additional 

I/O DESIRED, 

OEVIOF 

I OF 


/DISABLE PI OR NoP 


deviot 


/dimissal before interrupt 




/from this jot occurs 

/interrupt handlfr dismiss 

ROUTE 

dvoism 

lac 

DEVAC 

/RESTORE AC 

DVSWCH 

ION 


/ION OP NOP 


DBR 


/DE8REAK AND RESTORE 


JMP* 

DEVOUT 

/LINK, BANK/PAGE MQOE, MEMORY 


/PROTECT 


/IF THE HANDLER USES THE AUTO I NCREMENT , INDEX 
/OR EAE REGISTERS, THEIR CONTENTS 

/should be saved and restored, functions 

/POSSIBLY IGNORED SHOULD CONTAIN 
/PROPER INDEXING TO BYPASS 
/CAL ARGUMENT STRING 
/ 

/CODE TO BYPASS IGNORED FUNCTIONS 
/ 


0VIGN2 l S2 
JMP 


DVARGP 
D VC K 


/BYPASS Fill POINTER 



7.3.3 Example B. Special Device Handler for AF01B A/D Converter 


page; 

1 

R 


001 





1 

2 






/aoc handle* 

/ 



4m 

3 




701301 

A 

f 

AOSr*70l301 

/SKIP 

IF COnVERstOm FLAG IS SET 

4 




701304 

A 

AOSC* 701304 

/SELECT AND COMVfHT (ADC FLAG IS CLEARED 

5 







/AND A 

CONVERSION' IS INITIALISED) 

6 

7 




701312 

A 

ADRB«701312 

/READ 

CONVERTER PUFFER INTO AC AND CLEAR F l 

f 

8 






/ 

.globl 

aDC, 


9 




440000 

A 

I0X»IS? 



10 




000003 

A 

,MED*3 

/MED (MONITOR Error DIAGNOSTIC) 

11 






/ 



12 


00000 

R 

040150 

R 

AOC, OAC 

ADCALP 

/SAVE Cal pointer 

13 


00001 

P 

040151 

R 

OAC 

AO ARqP 

/and ARGUMENT pointer 

14 


00002 

R 

440151 

R 

I DX 

adargp 

/points to function code 

15 


00003 

R 

220151 

R 

LAC* 

AOARgP 

/GET COOE 

16 


30004 

R 

440151 

R 

10* 

adargp 

/POINTS TO CAL ♦ 2 

17 


00005 

R 

340154 

R 

TAD 

(JMP DSPCH 

18 


30006 

R 

040007 

R 

DAC 

OSPCW 

/DJSPATcm with 

19 


3 000 7 

R 

740040 

A 

OSPCM XX 


/modified jump 

20 


30010 

R 

600027 

R 

JMP 

aDINIT 

/1»,!N!t 

21 


30011 

R 

600074 

R 

JMP 

ADIGN2 

/2*,FSTat» .DLETE t ,RENAM 

22 


00012 

R 

600074 

R 

JMP 

ADIGN2 

/3* » SEEK 

23 


00013 

R 

600023 

R 

JMP 

ADERR6 

/4 5 , Enter 

24 


30014 

R 

600023 

R 

JMP 

ADERR6 

/5*,CLEaR 

25 


30015 

R 

600075 

R 

JMP 

AOlGNl 

/6*. CLOSE 

26 


00016 

R 

600075 

R 

JMP 

AOJGM 

/7* , mt Are 

27 


00017 

R 

600051 

R 

JMP 

adread 

/1*Js,REad 

28 


00020 

R 

600023 

R 

JMP 

ADERW6 

/ll* , WR I tE 

29 


00021 

R 

600044 

R 

JMP 

AOWAIT 

/l2* , WA I t 
/ 1 3 s , T R A N 

30 


00022 

R 

600023 

R 

JMP 

ADERR6 

31 






/ 



32 






/ILLEGAL FUNCTIONS in 

above table coded as 

33 






/ JMP 

ADERR6 


34 






, EJECT 





IGE 2 

p 


001 






35 





/ 




36 





/FUNCTION CODE 

ERROR 


37 





/ 




38 

,"0023 

R 

760006 

A 

ADERR6 

law 

6 

/EHROR code 6 

39 

0 0024 

k 

620195 

R 


JMP* 

( ,med*i 

/TO MONITOR 

40 





/DATA MODE ERROR 


41 

*0025 

R 

760007 

A 

ADERR7 

LAW 

7 

/ERROR CODE 7 

42 

0 0 0 26 

R 

620155 

R 


JMP* 

( » ME D + 1 

/TO monitor 

43 





/the adint Routine must 

include a .setup 

44 





/FOR EACH FLAG 

ASSOCIATED U ITH TwE OFVJcE 

45 





/ 




46 

0 0027 

R 

440151 

R 

ADINI T 

IOX 

ADARgP 

/ 1 ox TO RETURN buff $i?e 

47 






.DEC 



48 

00030 

R 

200166 

R 


lac 

(256 

/standard buffer si £f (Decimal) 

49 






,OCT 



5 0 

;003l 

R 

060151 

R 


0 A C * 

ADARGP 

/return it to USER 

51 

r 0 0 3 2 

R 

440151 

R 


IOX 

adargp 


52 

00033 

R 

000057 

A 

AOCMOO 

CAL 

57 

/5'=APJ CHANNEL 

53 

00034 

R 

000016 

A 

adcksm 

16 


/.setup i Op s function cone 

94 

00035 

R 

701301 

A 

aDCbp 

adsf 


/AOC SKIP IOT 

55 

00036 

R 

000111 

R 

ADUBHP 

AQCIM 


/AOOR, of interrupt 

56 

00037 

R 

200041 

R 

adund 

LAC 

.♦2 

/SET-UP n N c E ONLY 

57 

00040 

R 

040033 

R 

A OWC 

DAC 

AOCMOO 

/skip set-up code if more 

58 

0 0041 

R 

600042 

R 

AOWPCT 

JMP 

adstop 

/.Inits are DONE 

59 





/ 




60 





/STOP AOC ROUTINE CLEARS 

l/o underway switch 

61 





/ 




62 

00042 

R 

140037 

R 

AOSTQP 

D*M 

adund 


63 

0 0043 

R 

600075 

R 


JMP 

aD I G',1 

/return 

64 





/ 




65 





/THE PREVIOUS 

tags in the cal area are used tor 

66 





/storage during the actual .read function 

67 





/ 




68 





/ADCKSM 

IS FOR 

storing the checksum 

69 





/AOCRP 

IS TRF 

current buffer pouter 

70 





/ADLRHP 

IS The 

LINE DUFFER HEADER POINTER 

71 





/ADUND 

IS for 

device underway switch 

72 





/AOWC is used 

AS THE COUNTER 

73 





/ADWPCT 

IS USED TO STORE 

current word count 

74 





/ 




75 






.EJECT 





PACE 

3 

R 


001 


76 


00044 

R 

200037 

R 

'll 


00045 

R 

741200 

A 

78 

79 


00046 

R 

600075 

R 

80 


00047 

R 

703344 

A 

81 

82 

83 


00050 

R 

620150 

R 

34 


0.0051 

R 

200037 

R 

85 


00052 

R 

740201 

A 

86 


00053 

R 

600047 

R 

87 


00054 

R 

040037 

R 

88 


00055 

R 

220150 

R 

89 


00056 

R 

500157 

R 

90 


00057 

R 

740200 

A 

91 


00060 

R 

600025 

R 

92 


O0061 

R 

220151 

R 

93 


ii0062 

R 

040035 

R 

94 


0 0063 

R 

040036 

R 

95 


00064 

R 

440151 

R 

96 


0 0065 

R 

220151 

R 

97 


00066 

R 

040040 

R 

98 


30067 

R 

140041 

R 

99 


0 0070 

R 

140034 

R 

100 


00071 

R 

440035 

R 

101 

102 


'>0072 

R 

440035 

R 

103 


00073 

R 

701304 

A 

104 


•0 0074 

R 

440151 

R 

105 


■>0075 

R 

703344 

A 

106 

107 

108 


00076 

R 

620151 

R 

109 


n 0 0 7 7 

R 

200160 

R 

110 


,>0100 

R 

040U7 

R 

lit 


0 0101 

r> 

w 

040142 

R 

112 


0 0122 

R 

040145 

R 

113 


00103 

R 

040H5 

R 

114 


0 0104 

R 

600116 

R 

115 


|/0105 

R 

040153 

R 

116 


00106 

P 

220161 

R 

117 

118 


00107 

R 

040152 

R 


ADWAIT 

LAC 

AOUND 



SNA 




JMP 

ADIGN1 


/i/o UNDERWAY LO dp 


AD8IJSY 

D9R 



/ 

JMP* 

ADCALP 


/ 

AOREAO 

LAC 

aDUND 

/check to see IF I/o IS UNDERWAY 


shaicma 


/IE NOT SET it WITH -1 


JMP 

aDBUSY 

/ 1 T WAS set, CO BACK TO CAL 


DAC 

aDUND 

/set it 


lac* 

ADCALP 

/LOOK at mode 


AND 

(7000 

/0 ITS 6*s ONI Y 


S2A 


/iops binary? 


JMP 

ADERR7 

/NO, ERROR 


LAC* 

ADARDP 

/get line buffer header pointer 


DAC 

adcbp 

/store it 


DAC 

ADLBHP 

/also store it for later header 


IOX 

ADARGP 

/INCREMENT arg, POINTER 


LAC* 

ADARr.P 

/G*T -t.8|W,C(2*S COMP) 


DAC 

aowc 

/STORE IT IN WORD COUNTER 


OHM 

ADWPCT 

/hero wqpd count reg. 


OHM 

ADCKSM 

/?LRO ChfCkSuM REG, 


IDX 

aDC8p 

/get past HEADER PAIR 


IDX 

adcbp 

/NOW POINTING at beginning of 

/buffer 


ADSC 


/START i,JP DEVICE 

ADIGN2 

IOX 

aDardp 

/ I NCR , FOR EXIT 

ADIGfJl 

D8R 


/BREAK from level 4 


JMP* 

ADARr.P 

/RETURN after Cal 

/INTERRUPT HANDIER FOR 

i 

api or pic 

ONLY! 

LAC 

( NOP 



DAC 

ADCICN 



DAC 

aOCOnT 



DAC 

aDSWCH 



DAC 

tgnrpi 



JMP 

common 


aDCPIC 

DAC 

adcac 

/SAVF AC 


lac* 

(0) 

/SAVE Pc, LINK, EX, MODE 


OAC 

.EJECT 

aDCO ,! T 

/mem ,prot , 
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PAGE 4 

R 


001 






119 

00110 

R 

600116 

R 


JMP 

COMMON 


120 

00111 

9 

600105 

R 

AOCINT 

JMP 

ADCP ic 

/Pic entry 

121 

00112 

R 

040153 

R 


0 AC 

AOCAC 

/API ENTRY, SAVE AC 

122 

00113 

R 

200111 

R 


LAC 

ADC I n T 

/SAVE Pc, LINK, tx , mode 

123 

00114 

R 

040152 

R 


DAC 

adcout 

/mem , p Rq t 

124 

00115 

R 

600077 

R 

IGNRP1 

JMP 

ONLY! 


125 

00116 

R 

701312 

A 

COMMON 

adrb 


/read converter puffer 

126 

00117 

R 

700042 

A 

ADC I ON 

I ON 


/ENABLE Pic EOR other devices 

127 

0012? 

R 

060035 

R 


DAC* 

aDCBP 

/STORE DATA in user PUFFER 

128 

00121 

9 

440035 

R 


IDX 

aDCBp 

/inc, Buffer pointer 

129 

00122 

R 

440041 

R 


I OX 

aDWPCT 

/INC, WqpQ pair COUNTER 

130 

00123 

R 

340034 

R 


TAD 

ADCKSM 

/ADD CHEC k SUM 

131 

00124 

R 

040034 

R 


DAC 

adcksm 

/STORE it 

132 

00125 

9 

440040 

R 


IS* 

adwc 

/IS I/O COMPLETE 

133 

00126 

R 

600142 

R 


JMP 

ADCONT 

/no keep going 

134 

00127 

R 

200041 

R 


LAC 

aDWPCT 

/YES, COMPUTE WORD COUNT PAIR 

135 

0013? 

R 

740030 

A 


I AC 


/may be odd 

136 

00131 

R 

742030 

A 


SWHA 


/to TOP HALF 

137 

00132 

R 

740020 

A 


WAR 


/make wo. p.rs, 

138 

0 0133 

R 

530162 

R 


AND 

(377000 

/ 8 BITS ONLY 

139 

00134 

9 

060036 

R 


DAC* 

aDlbhP 

/STORE I N header n 

140 

^0135 

R 

440036 

R 


IDX 

adlbhp 

/inc, To store cksum 

141 

00136 

H 

340034 

R 


TAD 

adcksm 

/add word pair count 

142 

00137 

R 

060036 

R 


DAC* 

aDLSmP 

/$ t ORE in header u 2 

143 

00l4g 

R 

140037 

R 


D2M 

aDund 

/clear d e v i c F UNDERLAY 

144 

00141 

R 

600144 

R 


JMP 

aDDISM 

/e*it 

145 

0.0142 

R 

700302 

A 

A n c o \l T 

J OF 


/DISABLE PIC OR NOP 

146 

?0143 

R 

701304 

A 


AOSC 


/BEFORE INTERRUPT from This tot occurs 

147 





/interrupt handler dismiss rte 

140 





/ 




149 

00144 

R 

200153 

R 

ADDISM 

lac 

aDCAC 

/RESTORE AC 

150 






.EJECT 
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PACE 5 

R 


001 






151 

00145 

R 

700042 

A 


AOSWCH 

ION 

/JON OR v,QP 

152 

00146 

R 

703344 

A 



D8R 

/O^BREAK A\0 RESTORE 

153 

00147 

R 

620152 

R 



JMP* 

aDCouT /lINK,Ex,H00E»mEm,PR0T 

154 

00150 

R 

000000 

A 


aocalp 

0 

/ a^o cal pointer 

155 

00151 

R 

000000 

A 


aoargp 

0 

/AUQ ARGUMENT POINTER 

156 

00152 

R 

000000 

A 


aocout 

0 

/PC.UPm.MP 

157 

00153 

R 

000000 

A 


AOCAC 

0 

/AC saved were 

158 






/ 



159 



000000 

A 



i END 



00154 

R 

600007 

R 

•L 





00155 

R 

000004 

A 

*L 





O0156 

R 

000400 

A 

•t 





00157 

R 

007000 

A 

*L 





00160 

R 

740000 

A 

*1 





00161 

R 

000000 

A 

*L 





00162 

R 

377000 

A 

*L 





sm*00163 NO ERROR LINES 



PAGF 6 t? CROSS REFERENCE 


ADARCP 

0015 1 

13 

14 

15 

16 



96 

104 

106 

155# 

ADBUSY 

0 07 4 7 

f* 0 # 

86 



A DC AC 

0 015 3 

115 

121 

149 

157# 

AOCALP 

0 0 1 5 

12 

81 

88 

154# 

A 0 C B P 

O0733 

54# 

93 

100 

101 

ADC I NT 

00111 . 

55 

120 # 

122 


AOC1 ON 

00117 

110 

126* 



AQCKSM 

00734 

53# 

99 

130 

131 

AOCMon 

7 00 33 

52# 

57 



ADCONT 

0 014p 

111 

133 

145# 


AOCOUT 

0 015 7 

117 

123 

153 

156* 

ADCPIC 

0 0105 

115# 

127 



AOC, 

0070!* 

8 

12 * 



ADO I SM 

0 014 4 

144 

149* 



A 0 ERR 6 

00023 

23 

24 

28 

30 

ADERR7 

0 0 '.1 2 3 

41# 

91 



A01GN1 

0 07 75 

25 

26 

63 

78 

A D I G N 2 

0 07 7 4 

21 

22 

104# 


AOINJT 

0 00 27 

20 

46# 



ADUBWP 

" O 0 O 3 a 

55# 

94 

139 

140 

ADRR 

701317 

6 * 

125 



aDREaO 

00051 

27 

8 4# 



AOSC 

701304 

4# 

103 

146 


ADSF 

701301 

3# 

54 



AOSTOP 

0 00 4 7 

58 

62# 



ADSWCH 

00145 

112 

151# 



AOUND 

0 0 037 

56# 

62 

76 

84 

A D w A I T 

00044 

29 

76* 



ADWC 

0004O 

57# 

97 

132 


AQWPCT 

O0041 

58* 

98 

129 

134 

COMMON 

00116 

114 

119 

125* 


OSPCM 

O0007 

17 

18 

19# 


T OX 

440000 

9# 

14 

16 

46 



128 

129 

140 


IGNRPI 

O0115 

113 

124# 



ONLY1 

00077 

109* 

124 



.MED 

0O0003 

10 * 

39 

42 



46 50 31 92 9 5 

127 126 

141 

3B* 

103 * 

142 

87 143 

31 


95 100 101 1 0 4 



CHAPTER 8 


BOSS-15 

BOSS enables DOS users with a card reader and a line printer to run 
jobs sequentially, with a minimum of operator intervention. BOSS sup- 
ports a subset of the DOS system programs, and adds a line editor, its 
own resident and nonresident routines (called Resident BOSS and Non- 
resident BOSS) , and the Procedure Files. Paragraph 8.1 describes Pro- 
cedure Files. Figure 8-1 shows which monitor supports each system 
program. 

The DOS programs run by BOSS are identical to those run by DOS. Ex- 
ceptions are the Resident and Nonresident Monitors, which are ex- 
plained later. BOSS expands the information on Control Cards into 
a series of commands in the format expected by the DOS system pro- 
grams. Nonresident BOSS does this command expansion, and stores the 
expanded commands in a disk file, the Run Time File (RTF). Since DOS 
programs expect to communicate with an operator at a teleprinter, BOSS 
feeds the expanded commands to the programs via .DAT slots assigned 
to TTA. In BOSS mode, therefore, BOSS attaches .DAT-2 to the Run Time 
File, and directs most teleprinter output to the Line Printer. Pro- 
grams can force I/O to the teleprinter by setting bit 4 in .SCOM+52, 
and proceding with macros directed to TTA. 

Whenever bit 0 of .SCOM+52 is set, the System Loader Interface attaches 
the Resident BOSS code to the Resident Monitor. The main purposes 
of Resident BOSS are to (1) ensure that BOSS will retain control of 
the teleprinter, (2) feed commands to programs via the Run Time File, 

(3) properly route internal Monitor commands, such as .EXIT, .GET and 
.PUT, and (4) direct teleprinter output to the Line Printer. Figure 
8-2 illustrates the connections between the DOS Resident Monitor and 
the BOSS Resident Monitor that accomplish these changes. Figure 8-3, 
the flowchart for Resident BOSS, further describes Resident BOSS. 

Resident BOSS communicates with Nonresident BOSS by TRANing informa- 
tion to and from the first block of Nonresident BOSS. Nonresident 
BOSS gains control on all error conditions, such as IOPS, operator 
abort, Time Estimate exceeded, and after a B0SS15 command. Figure 8-4 
is a flowchart of Nonresident BOSS. 


8-1 



DOS 


BOSS 



15-0658 


Figure 8-1, BOSS/DOS Intersection 



RESIDENT B0SS15 INTERFACE TO RESIDENT MONITOR 
AND USER PROGRAM OR SYSTEM PROGRAM 


PROGRAM CONTROL 
INFORMATION FLOW 


'•IF QDUMP WAS SPECIFIED THEN THE DUMP 
WILL TAKE PLACE BEFORE GOING TO 
RESIDENT BOSS 15 


NOTE: SEE RESIDENT BOSS FLOW CHARTS 
FOR DETAILS. 



Figure 


8-2 















IOPS Error 
Routine : 
EXITLT 


Expanded 
IOPS Error 
Routine 
BOSS0 


Control Q 
Processing, 
via . SCOM+72 


IOPS.E (JMS Entry) 


RETURN 



et Expanded Error 
flag for Nonresident 
BOSS 



Store error data in 
Resident BOSS .ERR, 
.MED, and in the ad- 
dress pointed to by 
.SCOM+37 


wanted 


Go to CTRL 
Q Routine: 
MANSAV 


Monitor TRAN in the first block of 
Nonresident BOSS, starting at 
C ( . SCOM+ 2 ) 


Starting at C(.SC0M+2) + 44g, trans- 
fer IOPS error data to core image of 
block 


Set bit 5 of .SCOM+52 


Monitor TRAN block out 
to first block of Non- 
resident BOSS 


Points within the Resident Monitor which transfer control to Resident BOSS 


RESIDENT BOSS - 15 
Figure 8-3 









DAT3.B 



Processing for I/O Macros addressed to .DAT slots -2 or -3, or any slot assigned to TTA. 


Points within the Resident Monitor which transfer control to Resident BOSS - 15 


RESIDENT BOSS - 15 

Figure 8-3 (cont.) 
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.EXIT TIME OUT Operator .PUT and .GET 

Processing Processing Abort +T Processing 

EXITA TIMGON TTDDTR BOSS 2 



RESIDENT BOSS - 15 
Figure 8-3 (cont.) 
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Start Address 420 



Nonresident BOSS 

Figure 8-4 
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From Preceding Page 



Set bit 11 in Job 
Status word 


___ 1 

V 

t 

Set bit 10 
Status Word 

in job 


Print on Line Printer, 
"ILLEGAL .GET BY USER" 



Set bit 5 in Job 
Status Word 


± 

Print on Line Printer, 

"TERMINAL ERROR " 



Print on Line Printer, 
"LOAD ERROR ” 


^ 

Set bit 16 in JOB 
Status Word 





Nonresident BOSS 
Figure 8-4 (cont.) 
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Nonresident BOSS 

Figure 8-4 (cont.) 
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there 
an active 

\ j° b / 



it the^ s ' 
terminator 
S X codecs'* 


Pack character into 
account buffer 


r charac- 
ters reached 


Pad with nulls until nine 
characters have been packed 


Enter date and start time 
into account information 
buffer 


Start elapsed time clock, by 
depositing zero into .SCOM+34 


Print Job Start Message on LP 


Nonresident BOSS 


Figure 8-4 (cont.) 
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Nonresident BOSS 

Figure 8-4 (cont.) 
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Next Page 
Nonresident BOSS 
Figure 8-4 (cont.) 
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Issue 

. INIT to 

"RTF'*; 

zero 

all BOSS 

reg- 

isters 




y^"RTF" ^ 
longer than 

. 777 8 

lines / 


Print on LP, "RUN TIME I 



Nonresident BOSS 

Figure 8-4 (cont.) 
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8.1 PROCEDURE FILES 


To each BOSS command there corresponds a disk-resident ASCII file, 
called a Procedure File. The Procedure File contains DOS commands. 

When DOS executes the commands in the Procedure File, it carries out 
the function specified by the BOSS control card. The DOS commands 
in the Procedure Files contain fields (for instance, a file name) 
that Nonresident BOSS fills in with text strings from the control 
card. These fields are called, "Variable Fields". Before executing 
the DOS commands contained in the Procedure File, therefore, all the 
variable fields have to be resolved. This process is very similar to 
a macro expansion, where (1) DOS is the assembly language, (2) the 
BOSS command name is the macro name, (3) the contents of the BOSS 
control card are the macro arguments, and (4) the Procedure File is 
the macro definition. The expanded DOS commands are put in a Disk 
File, called the "Run Time File (RTF)". The RTF can contain the ex- 
pansion of one or more Procedure Files, up to 777 0 IOPS ASCII records. 

O 

BOSS expands Procedure Files strictly on a text string, character 
basis. It has no knowledge of the intrinsic function of each BOSS 
control card, except for $ JOB , $END, $CRT, and $ADD ($END, $CRT, $ADD 
have no Procedure Files) Appendix c contains a listing of all standard 
Procedure Files. 

8.1.1 Procedure File Format 

In order to ensure successful expansion, all Procedure Files must fol- 
low a strict format. The first record of the Procedure File must be 
a control record, with parameter information. The first record may 
also contain comments, because BOSS interprets only pertinent informa- 
tion, and ignores the rest. The numbers 0, 1, 2, 3, and 4 specify 
different options. All other characters are ignored. The option 
digits can appear in any order, and anywhere on the record. The op- 
tion specified by each number is given below: 

0 - Expanded Substitution (default, if "3" not given 
explicitly) 

This option specifies that the Procedure File is to be 
expanded according to the normal rules of substitution, 
which are given below. 
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1 


- Open Ended File (default, if "2" not given 
explicitly) 

This option instructs the Nonresident BOSS Monitor 
to leave the RTF open after expanding the current 
Procedure File. BOSS then searches for the next 
control card. 

2 - Closed End File 

This option instructs Non-resident BOSS to close 
the RTF after expanding the current Procedure File, 
and to execute the DOS commands in the RTF. Pro- 
cedure Files corresponding to commands that may 
possibly be followed by "Data Cards" should be 
of Type 2. 

3 - Direct Substitution 

This option indicates the BOSS should not expand 
the Procedure File according to normal rules. 

Refer to paragraph 8.1.2 for information on 
Direct Substitution. 

4 - Test Mode 

This option indicates that BOSS should echo the 
Procedure File expansion on the Line Printer. 

This allows a check on the Procedure File. 

The following combinations are illegal: 

0 and 3 

1 and 2 


If BOSS finds an illegal option combination, it will print, 

ILLEGAL PROC FILE 

and search for the next control card. 

BOSS uses all other records in the Procedure File as macro definition 
records. Records after the first one are all Macro Definition Records. 
For each such record, a record will be written in the RTF. Each Macro 
Definition Record has the same format. Two types of fields are used: 
K-fields and V-fields. K-fields specify constant character strings 
that will be written into the RTF exactly as they appear in the Pro- 
cedure File. V-fields specify variable character strings to be sub- 
stituted from specified strings on the Control Cards. Each Macro 
Definition Line of a Procedure File can contain any number of K- and 
V-fields, in any combination. V-fields are delimited by @-signs. 
K-fields are delimited by adjacent V-fields, or the end or beginning 
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of the record. Since there are only two types of fields, only one 
need have delimiters. Two adjacent V-fields, however, require two 
adjacent @-signs. 


K-fields 

K-fields may be any string of legal IOPS ASCII characters, except the 

@-sign. 

A V- field has the following format*: 

The two @-signs delimit the field. The first part of the field (A, 

D, U or 0) is a card-position identifier, and must be present. It 
identifies the position on the current Control Card of the character 
string to be substituted in the RTF. The legal combinations are: 

A00,A01, A09 

U00 ,\J01, . . . .U09 

D00,D01, DJ2T9 ,D10, . . .D17 

0 


With the exception of D10 through D17, each of the above position 
identifiers corresponds to a unique character string of the Control 
Card, according to the following scheme: 

$ CMD ; 0 A00-.D00 (U00) ; A01 : D01 (U01 ) ; ;A09:D09 (U09) 

The D10...D17 position identifiers do not correspond to character 
strings found on the Control Card, but rather to character strings 
defined by BOSS. Thus, 

D10 - Unused 

Dll - . SIXBT representation of the System Device Code 
('DK'or 'DP') 

D12 - Current Logged in UIC 

D13 - .SIXBT representation of Carriage RETURN 
D14 - .SIXBT representation of ALT MODE 
D15 - Unused . 

D16 - Unused 
D17 - Unused 


* Standards for this format description are identical to those speci- 
fied in Chapter 5 of the DOS-15 User's Manual, DEC-15-MRDA-D . 
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The parentheses in a V-field must be present. They are used to speci- 
fy a default string. The default string is used in case the string 
on the Control Card specified by the position identifier is null. A 
set of parentheses must be included, even if the default string is 
null. The default string itself can be a variable, resulting in nested 
variables. Nesting has a theoretical limit of 2 variable fields. 

8.1.2 Direct Substitution 

When processing a Direct Substitution Procedure File, BOSS places the 
fields on the Control Card into the RTF just as they stand with only 
leading spaces ignored. That is, BOSS does not necessarily expect to 
find file names, and so on, as with normal substitution. Fields on 
the Control Cards are separated by semi-colons (;), and are processed! 
in a serial manner. The ampersand (&) is used for a special purpose. 

It causes the current record being composed for the RTF to be termin- 
ated with a Carriage RETURN, and written out, and a new record started. 
This is so that the limit of seventy-five characters per line will not 
be exceeded. 

There are only two legal field types within the Procedure File. They 
are as follows : 

1. A00 through A99 

2. D10 through D17 (System Defined) 

In making up Direct Substitution Procedure Files, the following rules 
must be followed: 

1. The first line must contain a three (3). This declares 
the file to be direct substitution. 

2. The "A" fields must appear in sequential order, starting 
at A00 . Each "A" field can be used only once within the 
Procedure File. 

3. The "D" fields can only be "D10" through "D17". They 
can be used any number of times, in any order. 

4. Variable expressions must follow the standard V-field 
format, as in expanded substitution. 

8.1.3 Example of Procedure File 

The following example shows a typical Direct Substitution Procedure 
File, the Control Cards used to call it, and the resulting lines 
produced in the Run Time File. 
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Procedure File 1 - Map PRC 


3 PROCEDURE FILE TO RUN CHAIN WITH NO OVERLAYS 
CHAIN 

@A00 (TMPXCT) @@D14 ( ) @ 

@A01 (SZ) @@D14 () @ 

@A02 (FILTMP) @@D14 ( ) @ 

@D14 () @ 


Control Cards as They Appear 


$MAP TESTl ; SZ , VTC/ABC , DEF , NAMl , &NAM2 , ? 

$ *01 NAM3 , NAM4 ,NAM5/ ; TESTl , SUBl , SUB 2 , & ; 
$*02 SUB3 , SUB4 , SUB5 


Run Time File Liijies 


CHAIN ) 

TESTl (ALT MODE) 

S Z , VTC/ABC , DEF , NAMl , ) 

NAM2 , NAM3 , NAM4 , NAM5/ (ALT MODE) 
TESTl, SUBl, SUB2, 1 ) 

SUB 3 , SUB 4 , SUB5 (ALT MODE) 

(ALT MODE) 


Note: Dl4=Altmode, <ALTMODE> is an Altmode, and <CR> is a 

Carriage Return. 

8.2 BOSS-15 ACCOUNTING 

i 

BOSS has a very simple accounting mechanism. It keeps an account 
record for each job in a random access. file in the CTP UFD. Hence, 
the file is protected, and can only be accessed after successful ex- 
ecution of a $MIC command. 

i 

The name of the accounting file is ACCNTG nnn. (The first has an ex- 
tension of 001 .) Each file is ten physical blocks long, and contains 
enough information for 310 jobs, thirty-one per physical block. When 
BOSS fills up one file, it increments the extension, and starts a new 

one. Every time a job ends, BOSS checks whether ACCNTG 001 exists. 

i 

If it does not, BOSS creates one. If it does, BOSS checks whether 
it is full. If not full, BOSS makes a new entry; if full, BOSS 
iDirect Substitution File 
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searches for the first unused extension number. If all extension num- 
bers have been used (up to 999) BOSS prints this message to the opera- 
tor on the teleprinter: 

MAX NUMBER OF ACCOUNTING FILES REACHED 
PLEASE PROCESS AND DELETE THEM 

Every time the system manager processes an accounting file, therefore, 
he should delete the file. 


For each completed job, BOSS writes out an eight-word record to the 
accounting file. The records have the following format: 


Word # 


Content 


1 

2 

3 


} 


{ 


Job I . D . , 
in 

.SIXBT 


4 Date, packed mmddyy 

5 Start Time, in hhmmss 

6 End Time, in hhmmss 

7 Run Time, in hhmmss 

8 Terminal Job Status Word 


A word whose contents equal 777777 immediately follows the last job 

O 

accounting record in each physical block of the accounting file. 


8.3 B.PRE 


Figure 8-5 is a flowchart of B.PRE, the BOSS Line Editor. 
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/ Has 
file name 
been en- 
v. teredo 



Assume updated file name equals 
the original file name 


Read file name and extension 
from .DAT- 2 


Read a card from . DAT +5 



^ EOF \ 
or EDIT 
card ^ 


neither 



1. Set FLAG to 1 

Issue .ENTER to .DAT-14 


Write card image to .DAT-14 


Read a card image from .DAT+5 























b.pr£; 

Figure 8-5 (cont.) 
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/ Call ^ 
for . DAT 
Vs lot B^/ 


/Call V 
for . DAT 
v slot C ^ 


/ Call\ 
for .DAT 
■v slot A . 


//.DAT>s 
slot A in' 
'v. active ^ 


^/.DAT\ 
slot B in- 
s. active 


ERROR 
IOPS 17 


Swap descriptor 
blocks for .DAT 
slots A and B 


DAT 

slot C in- 
's^ active ^ 


Swap descriptor 
blocks for . DAT 
slots A and C 


IOPS 22 
ERROR 


there more than 
Yone output file on 
the same unit 



Get function code, and make up 
dispatch instruction 


there a^ 
mffer for^ 
this slot 
X N 


Request a buffer 


m 


Next Page 

DECtape ’A' Handler (DTA.) 


A-l 










From Preceding Page 





DECtape "A" Handler (DTA.) 
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c 


(.OPER, Function Code #2) 
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DECtape "A" Handler (DTA. ) 








DECtape "A" Handler (DTA. ) 
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I 


.WRITE 

(Function code 11) 


Loop back to user's CAL 


Jnderway 


Set "write executed" 
switch 


"any more 


current 
w block . 



2. search for next block 


a block 
avail- 
sable ^ 


1. Transfer user buffer to handler 
buffer 

2. Compute Checksum 


ERROR 
IOPS 15 



' Exit to 
user after 
CAL 



DECtape "A" Handler (DTA. ) 
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INTERRUPT SECTION 



A-8 
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B-l 












From Preceding Page 



Next Page 
Disk "A" Handlers 


(DISPCH) 
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From Preceding Page 



Request a buffer (.GTBUF) 



1. Save pointer to buffer, and zero entire buffer 

2, Complete the Busy Table entry 



* 

1. Get UIC from the Busy Table entry 

2. Bring in the Current Set from buffer 

3. Set up pointers to: User's Directory Entry, tem- 


porary block list. Data Block Words 0,1,2,3,376 & 
377 



Disk 


i 

"A" 


Handlers 
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B-4 
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(.RTRAN) 



oz 

relative 
block number 
Z number of 
‘file blockp' 


IOPS 11 


IOPS 66 


Calculate RIB block number, and the desired pointer’s 
position within that RIB block 



Depending on the location of the desired block, rela- 
tive to the RIB block in core, read in the next or 
preceding RIB block 



Save pointer to desired data block 


RF 



RF 
.or RP 


RP 


Store starting word number and the number 
of data words desired 



Assume transfer starting at word zero, 
through word 375, and set parameters 
accordingly 




Set direction switch 







Input 


Use word count given in CAL during disk 
pack input 



Disk "A" Handlers 
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Disk "A" Handlers 
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I 

Disk "A" Handlers 
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ENTSET 
Preallocate 
some blocks 


Read in last MFD block 


Did 

^ FINDER 
find an emp- 
Oty MFD slot 


Set pointer to free slot 
found by FINDER 


block ^ 
with free 
entry in 


< GETNXT \ 

Get next \ 
block number / 

i 

1. Make forward link of last MFD block 
point to the next block 
2. Write out the block 
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GETNXT 

Obtain a block 
for the UFD 


Set up entries in the Busy Table, the 
MFD block and the Current Set 


Write out the MFD block and clear the 
buffer 


1. Set up a new UFD block in the buffer, 
with a back link of -1 

2. Set pointer to indicate location to 
receive the new entry 
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’ES0L1 


/IS \ 
old file 
..truncated. 


/ WIPOUT \ 
Remove file 
entry from 
Vthe UFD / 


Set "Old file in” switch 
Set pointers to UFD block 
number and the first word 
of the old file's entry 
(to be used at .CLOSE) 


f CKDIRP \ 

Check directory \J PEgtec^iqn. 


srotection 


Violation 


TOPS 63 


f ENTSET \ 
Preallocate 
\some blocks/ 


Did 

^ FINDER 
locate a 
.free entry 
^“in UFD 


Read in first UfD block 


’ SEARCH 
Look for 
a free 
entry 


1. Read in UFD block with 
free entry 

2. Load "UFDl" pointer in 
Current Set with this 
block number 


Found 

free 


/ GETNXT 
( Obtain a 
\block # 


Change forward link of last UFD block 
(still in core) 

Write out last UFD block 
Clear user's buffer 











Disk "A" Handlers 


B-12 








1. Set up forward and backward links in buffer 

2. Set up words 0, 1 and 2 

3. Turn on bit in this submap corresponding 
to itself 

4. Write out the block 



1. Set backward and forward links to -1 

2. Turn on bits that correspond to MFD 
block and first submap block 




than N 
four plat-, 
^stera^^ 


Disk "A" Handlers 
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Next Page 


Disk "A" Handlers 


B-15 















Disk "A” Handlers 
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From Preceding Page 




Disk "A" Handlers 
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DISK "A" Handlers 
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READ-WRITE Common Setup Routine 


1 . 

2 . 



Save pointer to argument data block 
Set up return address 

Set pointer to checksum word in data buffer 
Save checksum word 




to Dump Mode exit 




Disk "A" Handlers 
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Word 

count 

zero 


Y 


Return 

to 


Set up for input or output 
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WR IT ] 


Has 
, ENTER 



Disk "A" Handlers 


B-23 














B-24 






B- 25 












,STFi: 
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APPENDIX C 


ASG 


1 ASSIGN DEVICE" NIC TO .DAT 
a ^ot?0(*nnn<»)® <®u(?3<pdi2< >p>p> <?a pzn? 

ASM 


? MACRO ant line EDITOR 

A 5»D?0(^Dll< )9)9 <»ue0(«»Ol2( >®>P> -14/(»O03 (®Dll ( )P)P <»u03<»Dl2n?)9> -15 

R.PRE 

«s A 00 ( ) P 

®A03(PA03(FIlTMP)®)# 

A PD00t<*Oll()«)P <PU20<PD12< )* >P> -11/<®Q01{®CU< )®>® <®U01 <®012 () ®) ®> -if* 
A ®O02(<5»Oll( >®>)0 <®U02<PO12( }®>P> -14 /i»D 03(^DU( )®>P <*U<?3 < PD1 2 ( ) ® ) »> -13 
A P D 0 4 ( L P ) ® <ff>U04(P0l2< )®)P> -12 
MACRO 

®0 < Bl )P«-«A00 ( F I LTMP ) PPD14 ( ) P 


BNK 

2 BANK moDE OPERATION-ON 
SANK ON 


BUF 

2 NUMBER OP PUFFERS 
RUFFS PA00 ( ) 9 

CHN 

1 SPECIFY 7 or 9 TRACK MAGTAPE 
c PA00 ( ) 9 

CMP 


1 SOURCE COMPARE 

A PD00<PQll( )P)® <?Ufl0 ( 9q12 ( ) P ) P> -15/P001 ( ^OU <) P ) P <PU^1 ( ®Dl2 ( )P ) P> -14 
SRCCOM 

frO< )«*■<« a 00 ( ) '•/PAD It )PPD14< )P 


DIR 

1 LIST DiRFCTCRY 

PIP 

I LP*PA0p ( ®D11 ( ) * ) ® KPUCf? ( PDl2 ( ) P ) ®>®D14 { ) P 
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DLG 


?. LOGOUT U I C 

logout 

DMP 


13 DUMP UTILTTV ■» DIRECT SUB FJLE 

A GD00(GO11( )G )G <#U00(»O12( )G)G> -14/GO01(LP)G <GU01<GD12< >(»)<»> -12 
(»A00( ALL)*GDl4< )® 


DOS 


1,3, GENERA^ PRC FILL FOR GIVING COMMANQ STRINGS 
»A00 ( GD14 < ) G ) 9 


FIL 


2 CREATE A ETLL FROM CAROS/ED I TOR 
A GD00(G0ll( )G)G <GU00<GO12< )G )G> -14 
A •D01<#D11( )•)• <®U01 <G012< )G)G> -15 
R.PRE 

®A00 < F I LTMP ) 5? 

S>A01(GAF0<FH TM P)»)9 


FCR 

2 FORTRAm IV AND LINE EDITOR ' 

A ®D00(t»Dll( >«►>• <Gq 12 ( )®)G> -14/FD01(*D11( )*>* <5»g0t <®0l2( )G>»> -15 

9 , PRF 
GA 00 < )G 

?A01(^A00(EIl tmp ) <p > p 

A »D00<»nil( )GJG <PU00<GD12< >G)G> -11/GQ01 <®D11 < )G)G <Gy0i < ®Ol2 ( ) G ) (•> -13 
A GO02<LP)® <GU02<*O12< )G)G> -12 

F 4 

*O(RL)G*'*A00(FILTMP)GSGD14( )G 


JOB 

2 START NEW JOB 

LOG JOB *A?0()G BEGIN GD14<)g 

T 

LOGIN PAPS < SCR ) G 

A NON 2, 3*4, 7*10*11*12*13, 14, 15, 16, 17, 20/GDlK JG 1 
PIP 

N G01K )G <SCP>®D14()G 
GA03 ( ) G 

KEEP GA04 ( OFF ) G 
TIMEST GA01<1)«I0O 
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KEP 


1 RETAIN DEVICE ASSIGNMENTS 
KEEP 0A0O< )0 


LCM 


13 SUPPLEMENT TO Lis PRC-UPQATE , l i br 
®A 5?0(CLOSE0Dl3( )®)0 0A01(0Dl3<}0>0 0A02()9 


LIB 

1 

A •D00(*Oll ( )®)& <9U00<0D12< )®) 0 > -14 

A e*D01 (9000 ( ®D11( >0)0)0 <0U01<9U00<0D12< } 9 ) 0 ) 0> -15 

A 0D02 ( 0011 < ) 0 > 0 <9U02<0D12< )0)0> -10 

A 0003 ( L p ) 0 <9U03<0D12< )®)®> -12 

UPDATE 

®O(LUS)0-^ ) A? *( ,LI8R>00D14< >0 


LNK 


13 DIRFCT SUB PILE - BUILDS LINKS FOR EXECUTE EIlE-USE WITH OVL rRC 
0AO0(0D14( ) 0 ) 0 v® D 1 4 ( )!a 


LOG 

2 LOGIN UlC 
LOGIN ®AOO(SCR)0 


LST 


2 LIST CONTENTS OF FILE ON LINE PRINTER 

PIP 

T LP*-0O00(0Dll< >0)0 <0U00<0D12< )0)0> 0A00 <FIlTMP)0 (A)0D14<)® 


MAP 


1*3 DIRECT Sub FILF FOR chain OPTION ANq res CODE Only 
CHAIN 

®A00 ( TMPXCT ) 00014 ( ) 0 
*A01 <S?)90D14 < )0 
0A02(FILTMP)*0O14< ) 0 
®D14 ( )0 


MIC 


2 LOGIN MIC NIC 
MlCLOG ®A0*?< ) 0 
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MNT 


1 MOUNT TAPE* ON DRIVE * 

LOG* MOUmT »o(D)ffl-TAPE# 9A00()P ON DRIVE# - WRITE 9 AO? < LOCK ) ® 


MSG 

13 MESSAGE To OPERATOR-DIRECT SUB FILE 
LOG »AO0 { )9 


MSW 

13 MESSAGE TO OPERATOR W/ W A I T -D I RE C T SUB 
L 0 G W »A0oO® 


NDR 

1 CREATE NEW DIRECTORY 
PIP 

v ®A00(»Dll{ )9)» <»U00(9D12( )»)6»><»D14 ( )* 


OVL 

13 DIRECT SUP FILE - USE FOR BUILDING OVERt A YS < CwA 1 N ) 
CHAIN 

®A00(TMpyCT)?(P!Dl4()» 

S> A 01 f S 2 ) ® 0 D 1 4 ( ) S> 

®AP!2(FU TMP)'J®D14( )t* 


PAG 


2 PAGE MqDE OPERATION-ON 
PAGE ON 


PCD 


2 SPECIFY PROTECTION CODE 
P $» A 0 0 ( 3 > » 


QDP 

i dump core on terminal errors-no arguments 

QDUMP 


XCT 


? execute 

A f»Dll ( )<?)® <*U00C®O12( )•)•> -*4 

E »A00(TmPXCT>® 
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INDEX 


Accessibility map, 6-9 

Additions to Non-resident Monitor, 3-4 
Automatic Priority Interrupt (API), 7-1 
hardware, 7-4 
implementation, 7-10 
ON/OFF, 4-19 
software, 7-6 


Bad Allocation Table (BAT) , 6-18 

Bank/Page mode, 7-1 

Batch mode .DAT slot assignments, 4-20 

Block checksum, 6-7 

Block control pair, 6-6, 6-7 

Block list, 6-14 

Block word count (BWC) , 6-6 

BOSS-15, 8-1 

accounting, 8-20 
.DAT slot assignments, 4-20 
line editor (B.PRE) , 8-21 

Bootstrap, system, 2-1, 2-7, 4-13 
Buffer allocation, 4-20, 5-12, 6-14 


CAL handler, 2-2, 7-1 
Characters, control, 2-14 
Clock operation, 2-12 
Clock routine, 2-8 
COMBLK, 4-13, 5-1 

Commands to Non-resident Monitor, 3-4 
Control characters, 2-14 
Current set, 6-14 


Data modes 
Dump, 6-4 
Image, 6-4 
IOPS, 6-4 
DDT loading, 4-13 
DECtape file organization, 6-1 
Device assignment table (.DAT), 5-12 

Device table, 5-11 
Disk file structure, 6-11 
Disk handler, 2-6 
Disk resident tables, 5-1, 5-9 
Directoried data recording, 6-5 
Directoried DECtape, 6-1 
Dump mode, 6-4 


Error handler, IOPS, 2-2 
Error processor, 2-2, 2-6 
EXECUTE, 4-13 


File accessibility map, 6-7 
File Bit Map, DECtape, 6-2 
File buffer transfer vector table, 5-12 
File identification and location, 6-7 
File information, see Current set 
File locating, 6-7 


File storage, 3-8 
FIOPS , 6-5 


Handlers, I/O device, 7-1 


Image mode, 6-4 
Input/Output (I/O) 

communication table, 5-11 
initialization, 2-8 
I/O device handlers, 7-1 
writing special, 7-9 
IOPS mode, 6-4 

error handler, 2-2 


Linking Loader, 4-13 
Link status, 7-1 
Loader buffer allocation, 4-2 O 
Loader, system, 4-1, 4-13 


Magnetic tape, 6-4 
file directory, 6-7 
handlers, 6-5 
storage retrieval, 6-11 
Mass Storage Busy Table, 5-13 
Master File Directory (MFD) , 6-12 
.MED error processor, 2-2 
Memory protect, 7-1 
Monitor, resident, 4-13 


Non-directoried DECtape, 6-1 
Nonresident Monitor, 2-12, 3-1 
additions, 3-4 
commands, 3-4 


Operation of DOS, 1-1 
Overlay Table, 5-9, 5-14 


Patch area, Resident Monitor, 2-14 
PATCH, commands to, 3-8 
PIC interrupt service routine 
implementation, 7-10 
PIP, 6-18 

Pre-allocation of blocks, 6-16 
Priority, software level, 7-1 
Procedure files, BOSS, 8-16 
Program control characters, 2-14 


Ofile, 3-8 
Queueing, 7-7 


RCOM table, 5-13 

Reserved word locations, 5-13 
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Resident Monitor, 2-1, 4-13 
PATCH area, 2-14 
timing features, 2-8 
Retrieval Information Block (RIB) , 
6-14 

Run time file (RTF), 8-1, 8-16 


.SCOM registers, 5-1 to 5-6 
used by Loaders, 4-17 to 4-19 
SGNBLK, 4-13, 5-1, 5-8, 5-10 
Skip chain, 5-12 
Software level priority, 7-1 
Special I/O device handlers, 7-9 
Startup routines, 2-8 
Storage, 4-26, 6-11, 6-16 
Storage allocation tables (SAT’s) 6-17 
Submaps, 6-17 
SYSBLK, 4-13, 5-1 
System 

bootstrap, 2-7 
initialization, 2-8 
Loader, 4-1, 4-13 


Tables used by Loaders, 4-16 
Temp List (TLIST) , see Block list 
.TIMER routine, 2-12 
Timing features, 2-8 
TRAN routine, 2-7 


User File Directory Table (.UFDT) 
5-12 

User file labels, 6-9, 6-10 

User identification code (UIC) ,6-12 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PD P-8 & PDP-12 
Digital Software News for the PDP-11 
Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Program Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 



READER'S COMMENTS 


DEC- 15 -ODFFA-A-D 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual . 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 


Did you find errors in this manual? If so, specify by page. 


How can this manual be improved? 


Other comments? 


Please state your position. 



Date: 

Name: 


Organization: 


Street: 


Department: 


City: 

State: 


Zip or Country 
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